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The Integrated Circuits 


1.1 The 68000 Processor 


The 68000 microprocessor is the heart of the entire Atari ST sy stem. This 
16-bit chip is in a class by itself; programmers and hardware designers alike 
find the chip veiy easy to handle. From its initial development by Motorola 
in 1977 to its appearance on the market in 1979, the chip was to be a 
competitor to the INTEL 8086/8088 (the processor used in the IBM-PC and 
its many clones). Before the Atari STs arrival on the marketplace, there 
were no affordable 68000 machines available to the home user. Now, 
though, with 16-bit computers becoming more affordable to the common 
man, the 8-bit machines won't be around much longer. 

What does the 68000 have that's so special? Here’s a very incomplete list 
of features: 


16 data bits 

24 address bits (16-megabyte address range!!) 
all signals directly accessible without multiplexer 
hassle-ftee operation of "old" 8-bit peripherals 
powerful machine language commands 
easy-to-leam assembler syntax 
14 different types of addressing 

17 registers each having 32-bit widths 

These specifications (and many yet to be mentioned here) make the 68000 
an incredibly good microprocessor for home and personal computers. In 
fact, as the price of memory drops, you’ll soon be seeing 68000-based 64K 
machines for the same price as present-day 8-bit computers with the same 
amount of memory. 
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1.1.1 The 68000 Registers 


Let’s take a look at 68000 design. Figure 1.1-1 shows the 17 onboard 
32-bit registers, the program counter and the status register. 

The eight data registers can store and perform calculations, as well as the 
normal addressing tasks. Eight-bit systems use the accumulators for this, 
which limits the programmer to a total of 8 accumulators. Our 68000 data 
registers are quite flexible; data can be handled in 1-, 8-, 16- and 32- bit 
sizes. Even four-bit operations are possible (within the limits of Binary 
Coded Decimal counting). When working with 32-bit data, all 32 bits can 
be handled with a single operation. With 8- and 16-bit data, only the 8th or 
16th bit of the data register can be accessed. 

The address registers aren't as flexible for data access as are the data 
registers. These registers are for addressing, not calculation. Processing 
data is possible only with word (16-bit) and longword (32-bit) operations. 
The address registers must be looked at as two distinct groups, the most 
versatile being the registers A0-A6. Registers A7 and A7’ fulfill a special 
need. These registers are used as the stack pointer by the processor. Two 
stack pointers are needed to allow the 68000 to run in USER MODE and 
SUPERVISOR MODE. Register A7 declares whether the system is in 
USER or SUPERVISOR mode. Note that the two registers work "under" 
A7, but the register contents are only available to the respective operating 
mode. We’ll discuss these operating modes later. 

The program counter is also considered a 32-bit register. It is theoretically 
possible to handle an address range of over 4 gigabytes. But the address 
bits A24-A31 aren’t used, which "limits" us to 16 megabytes. 

The 68000 status register comprises 16 bits, of which only 10 bits are used. 
This status register is divided into two halves: The lower eight bits (bits 0 
to 4 proper) is the "user byte". These bits, which act as flags most of the 
time, show the results of arithmetical and comparative operations, and can 
be used for program branches hinging on those results. We’ll look at the 
user byte in more detail later; for now, here is a brief list: 

BIT 0 = Carry flag BIT 1 = Overflow flag 

BIT 2 = Zero flag BIT 3 = Negative flag 

BIT 4 - extend flag 
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Figure 1.1-1 680001 
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Bits 8-10, 13 and 15 make up the status register’s system byte. The 
remaining bits are unused. Bit 15 works as a trace bit, which lets you do a 
software controlled single-step execution of any program. Bit 13 is the 
supervisor bit. When this bit is set, the 68000 is in supervisor mode. This 
is the normal operating mode; all commands are executed in this mode. In 
user mode, in which programs normally run, privileged instructions are 
inoperative. A special hardware design allows access into the other memory 
range while in user mode (e.g., important system variables, I/O registers). 
The system byte of the status register can only be manipulated in supervisor 
mode; but there's a simple method of switching between modes. 

Bits 8 and 10 show the interrupt mask, and run in connection with pins 
IPL0-IPL2. 

The 68000 has great potential for handling interrupts. Seven different 
interrupt priorities exist, the highest being the "non-maskable interrupt"; 
NMI. This interrupt recognizes when all three EPL pins simultaneously read 
low (0). If, however, all three IPL pins read high, there is no interrupt, and 
the system operates normally. The other six priorities can be masked by 
appropriate setting of the system byte of the status register. For example, if 
bit 12 of the interrupt mask is set, while 10 and II are off, only levels 7, 6 
and 5 (000, 001 and 010) are recognized. All other combinations from 
IPL0-IPL2 are ignored by the processor. 
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1.1.2 Exceptions on the 68000 


We've spoken of interrupts as if the 68000 behaves like other 
microprocessors. Interrupts, according to Motorola nomenclature, are an 
external form of an exception (the machine can interrupt what it's doing, 
do something else, and return to the interrupted task if needed). The 68000 
distinguishes between normal operation and exception handling, rather than 
between user and supervisor mode. One such set of exceptions is the 
interrupts. Other things which cause exceptions are undefined opcodes, and 
word or longword access to a prohibited address. 


To make exception handling quicker and easier, the 68000 reserves the first 
IK of memory (1024 bytes, $000000-$0003FF). The exception table is 
located here. Exceptions are all coded as one of four bytes of a longword. 
Encountering an exception triggers the 68000, and the address of the 
corresponding table entry is output 


A special exception occurs on reset, which requires 8 bytes (two 
longwords); the first longword contains the standard initial value of the 
supervisor stack pointer, while the second longword contains the address of 
the reset routine itself. See Chapter 3.3 for the design and layout of the 
exception table. 


1.1.3 The 68000 Connections 


The connections on the 68000 are divided into eight groups (see Figure 
1.1-3 on page 11). 

The first group combines data and address busses. The data bus consists of 
pins D0-D15, and the address bus A1-A23. Address bit A0 is not available 
to the 68000. Memory can be communicated with words rather than bytes 
(1 word=2 bytes=16 bits, as opposed to 1 byte=8 bits). Also, the 68000 
can access data located on odd addresses as well as even addresses. The 
signals will be dealt with later. 

It’s important to remember in connection with this, that by word access to 
memory, the byte of die odd address is treated as the low byte, and the even 
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address is the high byte. Word access shouldn't stray from even addresses. 
That means that opcodes (whether all words or a single word) must always 
be located at an even addresses. 

When the data and address bus are in "tri-state" condition, a third condition 
(in addition to high and low) exists, in which the pins offer high resistance, 
and thus are inactive on the bus. This is important in connection with Direct 
Memory Access (DMA). 


The second group of connections comprise the signals for asynchronous 
bus control. This group has five signals, which we'll now look at 
individually: 


1) RAV (READ/WRITE) 

The R/W signal is a familiar one to all microprocessors. This 
indicates to memory and peripherals whether the processor is writing 
to or reading data from the address on the bus. 


2) AS (ADDRESS STROBE) 

Every processor has a signal which it sends along the data lines 
signaling whether the address is ready to be used. On the 68000, this 
is known as the ADDRESS STROBE (low active). 

3) UDS (UPPER DATA STROBE) 

4) LDS (LOWER DATA STROBE) 

If the 68000 could only process an entire memory word (two bytes) 
simultanesouly, this signal wouldn't be necessary. However, for 
individual access to the low-byte and high-byte of a word, the 
processor must be able to distinguish between the two bytes. This is 
the task performed by UDS and LDS. When a word is accessed, 
both strobes are activated simultaneously (active=low). Accessing 
the date at an odd address activates the Lower Date Strobe only, while 
accessing date atan even address activates the Upper Data Strobe. 

Bit A0 from the address bus is used in this case. After every access 
when the system must distinguish between three conditions (word, 
even byte, odd byte), A0 determines how to complete the access. 

LDS and UDS are tri-state outputs. 
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5) DTACK 

The above signals (with the exception of UDS and LDS) are needed 
by an 8-bit processor. DTACK takes a different path; DTACK must 
be low for any write or read access to take place. If the signal is not 
low within a bus cycle, the address and data lines ’’freeze up” until 
DTACK turns low. This can also occur in a WAIT loop. This way, 
the processor can slow down memory and peripheral chips while 
performing other tasks. If no wait cycles are used on the ST, the 
processor moves "at full tilt”. 


The third group of connections, the signals VMA, VPA and E are for 
synchronous bus control. A computer is more than memory and a 
microprocessor; interfaces to keyboard, screen, printer, etc. must be 
available for communication. In most cases, interfacing is handled by 
special ICs, but the 68000 has a huge selection of interfaces chips onboard. 
For hardware designers well take a little time explaining these synchronous 
bus signals. 

The signal E (also known as <I>2 or phi 2) represents the reference count for 
peripherals. Users of 6800 and 6502 machines know this signal as the 
system counter. Whereas most peripheral chips have a maximum frequency 
of only 1 or 2 mHz, the 68000 has a working speed of 8 mHz, which can 
increased to 10 by the E signal. The frequency of E in the ST is 800 kHz. 
The E output is always active; it is not capable of a TRI- STATE condition. 


The signal VPA (Valid Peripheral Address) sends data over the 
synchronous bus, and delegates tins transfer to specific sections of the chip. 
Without this signal, data transfer is performed by the asynchronous bus. 
VPA also plays a role in generating interrupts, as we’11 soon see. 

VMA (Valid Memory Address) works in conjunction with the VPA to 
produce the CHIP-select signal for the synchronous bus. 


The fourth group of 68000 signals allows simple DMA operation in the 
68000 system. DMA (Direct Memory Access) directly accesses the DMA 
controllers, which control computer memory, and which is the fastest 
method of (lata transfer within a computer system. 

To execute the DMA, the processor must be in an inactive state. But for the 
processor to be signaled, it must be in a "sleep" state; the low BR signal 
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(Bus Request) accomplishes this. On recognizing the BR signal, the 
68000’s read/write cycle ends, and the BG signal (Bus Grant) is activated. 
Now the DMA-requested chip waits until the signals AS, DTACK and 
(when possible) BGACK are rendered inactive. As soon as this occurs, the 
BGACK (Bus Grant Acknowledge) is activated by the requested chip , and 
takes over the bus. All essential signals on the processor are made high; in 
particular, the data, address and control busses are no longer influenced by 
the processor. The DMA controller can then place the desired address on 
the bus, and read or write data. When the DMA chip is finished with its 
task, the BGACK signal returns to its inactive state, and the processor again 
takes over the bus. 


rhe fifth group of signals on the 68000 control interrupt generation. The 
68000’s "user's choice" interrupt concept is one of its most extraordinary 
performing qualities; you have 199 (!) interrupt vectors from which to 
choose. These interrupt vectors are divided into 7 non-auto-vectors and 192 
auto- vectors, plus 7 different priority lines. 

Interrupts are triggered by signals from the three lines IPLO to IPL2; these 
three lines give you eight possible combinations. The combination 
determines the priority of the interrupt. That is, if IPLO, EPL1 and IPL2 are 
all set high, then the lowest priority is set ("no interrupt"). However, if all 
three lines are low, then highest priority takes over, to execute a 
non-maskable interrupt All the combinations in between affect special bits 
in the 68000’s status register; these, in turn, affect program control, 
regardless of whether or not a chosen interrupt is allowable. 

Wait - what are auto-vectors and non-auto-vectors? What do these terms 
mean? 

If requesting an interrupt on EPL0-IPL2 while VPA is active (low), the 
desired code is directly converted from the IPL pins into a vector number. 
All seven interrupt codes on the IPL pins have their own vectors, though. 
The auto- vector concept automatically gives the vector number of the IPL 
interrupt code needed. 


When DTACK, instead of VPA, is active on an interrupt request, the 
interrupt is handled as a non-auto-vector. In this case, the vector number 
from the triggered chip is produced by DTACK on the 8 lowest bits of the 
data bus. Usually (though not important here), the vector number is placed 
mto the user- vector range ($40~$FF). 
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The sixth set of connections are the three "function code" outputs FCO to 
FC2. These lines handle the status display of the processor. With the help 
of these lines, the 68000 can expand to four times 16 megabytes (64 
megabytes). This extension requires the MMU (Memory Management 
Unit). This MMU does more than handle memory expansion on the ST; it 
also recognizes whether access is made to memory in user or supervisor 
mode. This information is conveyed to a memory range only accessible in 
supervisor mode. Also, the interrupt verification uses this information on 
the FC line. The figure below shows the possible combinations of 
functions. 


Figure 1.1-3 
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The seventh group contains system control signals. This group applies to 
the input CLK and BERR, as well as the bidirectional lines RESET and 
HALT. 

The input CLK will generate the working frequency of the processor. The 
68000 can operate at different speeds; but the operating frequency must be 
specified (4, 6, 8, 10, or even 12.5 mHz). The ST has 8 mHz built in, 
while the minimum operating frequency is 2 mHz. The ST's 8 mHz was 
chosen as a "middle of the road" frequency to avoid losing data at higher 
frequencies. 

The RESET line is necessary to check for system power-up. The 68000's 
data page distinguishes between two different reset conditions. On 
power-up, RESET and HALT are switched low for at least 100 
milliseconds, to set up a proper initialization. Every other initialization 
requires a low impulse of at least 4 "beats" on the 68K. 

Here is what RESET does in detail. The system byte of the status register is 
loaded with the value $27. Once the processor is brought into supervisor 
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status, the Trace flag in the status register is cleared, and the interrupt level 
is set to 7 (lowest priority, all lines allowable). Additionally, the supervisor 
stack pointer and program counter are loaded with the contents of the first 8 
bytes of memory, whereby the value of the program counter is set to the 
beginning of the reset routine. 

However, since the RESET line is bi-directional, the processor can also 
have RESET under program control during the time the line is low. The 
RESET instruction serves this purpose, when the connection is low for 124 
"beats”. It’s possible to re-initialize the peripheral ICs at any time, without 
resetting the computer itself. RESET time puts the 68000 into a NOP state 
— a reset is unstoppable once it occurs. 

The HALT pin is important to the RESET line's existence (as we mentioned 
above), in order to initialize things properly. This pin has still more 
functions: when the pin is low while RESET is high, the processor goes 
into a halt state. This state causes the DMA pin to set the processor into the 
tri-state condition. The HALT condition ends when HALT is high again. 
This signal can be used in the design of single-step control. 

HALT is also bi-directional. When the processor signals this line to become 
low, it means that a major error has occurred (e.g., doubled bus and 
address errors). 

A low state on the BERR pin will call up exception handling, which runs 
basically like an external interrupt. In an orderly system, every access to the 
asynchronous bus quits with the DTACK signal. When DTACK is 
outputting, however, the hardware can produce a BERR, which informs the 
processor of any errors found. A further use for BERR is in connection 
with the MMU, to test for proper memory access of a specific range; this 
access is signaled by the FC pins. If protected memory is tried for in user 
mode, a BERR will turn up. 

When both BERR and HALT are low, the processor will "re-execute" the 
instruction at which it stopped. If it doesn’t run properly on the second 
"go-round", then it's called a doubled bus error, and the processor halts. 

The eighth group of connections are for voltage and ground. 
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1.2 The Custom Chips 


The Atari ST has four specially developed ICs. These chips (GLUE, 
MMU, DMA and SHIFTER) play a major role in the low price of the ST, 
since each chip performs several hundred overlapping functions. The first 
prototype of the ST was 5 X 50 X 30 cm. in size, mostly to handle all those 
TTL ICs. Once multiple functions could be crammed into four ICs, the ST 
became a saleable item. Then again, the present ST hasn't quite reached the 
ultimate goal — it still has eight TTLs. 

Naturally, since these chips were specifically designed by Atari for the ST, 
they haven’t been publishing any spec sheets. Even without any data specs, 
we can give you quite a bit of information on the workings of the ICs. 

An interesting fact about these ICs is that they’re designed to work in 
concert with one another. For example, the DMA chip can’t operate alone. 
It hasn't an address counter, and is incapable of addressing memory on its 
own (functions which are taken care of by the MMU). It's the same with 
SHIFTER ~ it controls video screen and color, but it can’t address video 
RAM. Again, MMU handles the addressing. 

The system programmer can easily figure out which IC has which register. 
It is only essential to be able to recognize the address of the register, and 
how to control it. We’re going to spend some time in this chapter exploring 
the pins of the individual ICs. 

The most important IC of the "foursome" is GLUE. Its title speaks for the 
function — a glue or paste. This IC, with its 68 pins, literally holds the 
entire system together, including decoding the address range and working 
the peripheral ICs. 

Furthermore, the DMA handshake signals BR, BG and BGACK are 
produced/output by GLUE. The time point for DMA request is dictated by 
GLUE by the signal from the DMA controller. GLUE also has a BG (Bus 
Grant) input, as well as a BGO (Bus Grant Out). 

The interrupt signal is produced by GLUE; in the ST, only IPL1 and IPL2 
are used for this. Without other hardware, you can't use NMI (interrupt 
level 7). The pins MFPINT and IACK are used for interrupt control. 
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Figure 1.2-1 GLUE 
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The function code pins are guided by GLUE, where memory access tasks 
are performed (range testing and access authorization). Needless to say, the 
BERR signal is also handled by this chip. VPA is particularly important to 
the peripheral ICs and the appropriate select signals. 

GLUE generates a timing frequency of 8 mHz. Frequencies between 2 
mHz (sound chip's operating frequency) and 500 kHz (timing for keyboard 
and MIDI interface) can be produced. 

HSYNC, VSYNC, BLANK and DE (Display Enable) are generated by 
GLUE for monitor operation. The synchronous timing can be switched on 
and off, and external sync-signals sent to the monitor. This will allow you 
to synchronize the ST’s screen with a video camera. 

The MMU also has a total of 68 pins. This IC performs three vital tasks. 
The most important task is coupling the multiplexed address bus of dynamic 
RAM with the processor’s bus (handled by address lines A1 to A21). This 
gives us an address range totaling 4 megabytes. Dynamic RAM is 
controlled by RASO, RAS1, CASOL, CASOH, CAS1L and CAS1H, as 
well as the multiplexed address bus on the MMU. DTACK, R/W, AS, LDS 
and UDS are also controlled by MMU. 

We've already mentioned another important function of the MMU: it works 
with the SHIFTER to produce the video signal (the screen information is 
addressed in RAM, and SHIFTER conveys the information). Counters are 
incorporated in the MMU for this; a starting value is loaded, and within 500 
nanoseconds, a word is addressed in memory and the information is sent 
over DCYC. The starting value of the video counter (and the screen 
memory position) can be shifted in 256-byte increments. 

Another integrated counter in MMU, as mentioned earlier, is for addressing 
memory using the DMA. This counter begins with every DMA access (disk 
or hard disk), loading the address of the data being transferred. Every 
transfer automatically increments the counter. 

The SHIFTER converts the information in video RAM into impulses 
readable on a monitor. Whether the ST is in 640 X 200 or 320 X 200 
resolution, SHIFTER is involved. 
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Figure 1.2-2 MMU 
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Figure 1.2-3 SHIFTER 


XTL 0 

XTL 1 32MHZ in 
D 0 
D 1 
D 2 
D 3 
D 4 
D 5 
D 6 
D 7 

LOAD* 
D 8 
D 9 
DIO 
Dll 
D 1 2 
D 1 3 
D 1 4 
D 1 5 
GND 


£ 

C 

c 

c 


CO 

EC 

H 

hd 

M 


D E 
A 1 


A 

A 

A 

A 


2 

3 

4 

5 


) V c c 
^ 16MHZ 
) CS* 

) 

) 

) 

) 

) 

) 

} R/W* 
) MONO 
) R 0 

)* 

) R 

)<= 

) G 
) 

) 

) 


1 

2 

0 

1 

2 

0 

1 

2 


out 


17 








Abacus Software 


Atari ST Internals 


The information from RAM is transferred to SHIFTER on the signal 
LOAD. A resolution of 640 X 400 points sends the video signal over the 
MONO connector. Since color is impossible in that mode, the RGB 
connection is rendered inactive. The other two resolutions set MONO 
output to inactive, since all screen information is being sent out the RGB 
connection in those cases. 

The third color connection works together with external equipment as a 
digital/analog converter. Individual colors are sent out over different pins, 
to give us color on our monitor. Pins Rl- R5 on the address bus make up 
the "palette registers". These registers contain the color values, which are 
placed in individual bit patterns. The 16 palette registers hold a total of 16 
colors for 320 X 200 mode. Note, however, that since these are based on 
the "primary" colors red, green and blue, these colors can be adjusted in 8 
steps of brightness, bringing the color total to 5 12. 

The DMA controller is like SHIFTER, only in a 40-pin housing; it is used 
to oversee the floppy disk controller, the hard disk, and any other 
peripherals that are likely to appear. 

The speed of data transfer using the floppy disk drive offers no problems to 
the processor. It's different with hard disks; data moves at such high speed 
that the 68000 has to send a "pause" over the 8 mHz frequency. This pace 
is made possible by the DMA. 

The DMA is joined to the processor's data bus to help transfer data. Two 
registers within the machine act as a bi-directional buffer for data through 
the DMA port; we'll discuss these registers later. One interesting point: 
The processor's 16-bit data bus is reduced to 8 bits for floppy /hard disk 
work. Data transfer automatically transfers two bytes per word. 

The signals CA1, CA2, CR/W, FDCS and FDRQ manage the floppy disk 
controller. CA1 and CA2 are signals which the floppy disk controller 
(FDC) uses to select registers. CR/W determine the direction of data 
transfer from/to the FDC, and other peripherals connected to the DMA port. 

The RDY signal communicated with GLUE (DMA-request) and MMU 
(address counter). This signal tells the DMA to transfer a word. 

As you can see, these ICs work in close harmony with one another, and 
each would be almost useless on its own. 
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Figure 1.2-4 DMA 
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1.3 The WD 1772 Floppy Disk Controller 


Although the 1772 from Western Digital has only 28 pins, this chip contains 
a complete floppy disk controller (FDC) with capabilities matching 40-pin 
controllers. This IC is software-compatible with the 1790/2790 series. 
Here are some of the 1772’s features: 

Simple 5- volt current 
Built-in data separator 
Built-in copy compensation logic 
Single and double density 
Built-in motor controls 

Although the user has his/her choice of disk format, e.g. sector length, 
number of sectors per track and number of tracks per diskette, the "normal" 
format is the optimum one for data transfer. So, Apple or Commodore 
diskettes can't be used. 

Before going on to details of the FDC, let's take a moment to look at the 28 
pins of this IC. 


1.3.1 1772 Pins 


These pins can be placed in three categories. The first group consists of the 
power connections. 

Vcc: 

+5 volts current. 

GND: 

Ground connection. 

MR: 

Master reset. FDC reinitializes when this is low. 

The second set are processor interface pins. These pins carry data between 
the processor and the FDC. 
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Figure 1.3-1 FDC 1772 
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D0-D7: 

Eight-bit bi-directional bus; data, commands and status 
information go between FDC and system. 

CS: 

FDC can only access registers when this line is low. 

R/W: 

Read/Write. This pin states data direction. HIGH= read by FDC, 
LOW= write from FDC. 

A0,A1: 

These bits determine which register is accessed (in conjunction 
with R/W). The 1772 has a total of five registers which can both 
read and write to some degree. Other registers can only read OR 
write. Here is a table to show how the manufacturer designed 
them: 


A1 

0 

0 

1 

1 


M R/W=l 

0 Status Reg . 

1 Track Reg . 

0 Sector Reg. 

1 Data Reg . 


r/w=h 

Command Reg . 
Track Reg. 
Sector Reg. 
Data Reg. 


DRQ: 

Data Request When this output is high, either the data register is 
full (from reading), and must be "dumped", or the data register is 
empty (writing), and can be refilled. This connection aids the 
DMA operation of the FDC. 

CLK: 

Clock. The clock signal counts only to the processor bus. An 
input frequency of 8 mHz must be on, for the FDC's internal 
timing to work. 


The third group of signals make up the floppy interface. 

STEP: 

Sends an impulse for every step of the head motor. 

DIRC: 

Direction. This connection decides the direction of the head; high 
moves the head towards center of the diskette. 
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RD: 

Read Data. Reads data from the diskette. This information 
contains both timing and data impulses — it is sent to the internal 
data separator for division. 

MO: 

Motor On. Controls the disk drive motor, which is automatically 
started during read/write/whatever operations. 

WG: 

Write Gate. WG will be low before writing to diskette. Write 
logic would be impossible without this line. 

WD: 

Write Data. Sends serial data flow as data and timing impulses. 

TROO: 

Track 00. This moves read/write head to track 00. TROO would 
be low in this case. 

IP: 

Index Pulse. The index pulses mark the physical beginnings of 
every track on a diskette. When formatting a disk, the FDC 
marks the start of each track before formatting the disk. 


WPRT: 

Write Protect. If the diskette is write-protected, this input will 
react. 


DDEN: 

Double Density Enable. This signal is confined to floppy disk 
control; it allows you to switch between single-density and 
double-density formats. 
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1.3.2 1772 Registers 


CR (Command Register): 

Commands are written in this 8-bit register. Commands should 
only be written in CR when no other command is under 
execution. Although the FDC only understands 1 1 commands, 
we actually have a large number of possibilities for these 
commands (we'll talk about those later). 

STR (Status Register): 

Gives different conditions of the FDC, coded into individual bits. 
Command writing depends on the meaning of each bit. The 
status register can only be read. 

TR (Track Register): 

Contains the current position of the read/write head. Every 
movement of the head raises or lowers the value of TR 
appropriately. Some commands will read the contents of TR, 
along with information read from the disk. The result affects the 
Status Register. TR can be read/written. 

SR (Sector Register): 

SR contains the number of sectors desired from read/write 
operations. Like TR, it can be used for either operation. 

DR (Data Register): 

DR is used for writing data to/ reading data from diskette. 
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1.3.3 Programming the FDC 


Programming this chip is no big deal for a system programmer. Direct (and 
in most cases, unnecessary) programming is made somewhat harder AND 
drastically simpler by the DMA chip. The 1 1 FDC commands are divided 
into four types. 

Type Function 

1 Restore, look for track 00 

1 Seek, look for a track 

1 Step, a track in previous direction 

1 Step In, move head one track in (toward disk hub) 

1 Step Out, move head one track out (toward edge of disk) 

2 Read Sector 

2 Write Sector 

3 Read Address, read ID 

3 Read Track, read entire track 

3 Write Track, write entire track (format) 

4 Force Interrupt 


Type 1 Commands 

These commands position the read/write head. The bit patterns of these five 
commands look like this: 

BIT 



7 

6 

5 

4 

3 

2 

1 

0 

Restore 

0 

0 

0 

0 

H 

V 

R1 

R0 

Seek 

0 

0 

0 

1 

H 

V 

Rl 

R0 

Step 

0 

0 

1 

U 

H 

V 

R1 

R0 

Step In 

0 

1 

0 

U 

H 

V 

Rl 

R0 

Step Out 

0 

1 

1 

U 

H 

V 

Rl 

R0 
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All five commands have several variable bits; bits RO and R1 give the time 
between two step impulses. The possible combinations are: 

R1 RO STEP RATE 

0 02 milliseconds 

0 13 milliseconds 

1 05 milliseconds 

1 16 milliseconds 

These bits must be set by the command bytes to the disk drive. The V-bit is 
the so-called "verify flag". When set, the drive performs an automatic 
verify after every head movement. The H-bit contains the spin-up 
sequence. The system delays disk access until the disk motor has reached 
300 rpm. If the H-bit is cleared, the FDC checks for activation of the 
motor-on pins. When the motor is off, this pin will be set high (motor on), 
and the FDC waits for 6 index impulses before executing the command. If 
the motor is already running, then there will be no waiting time. 

The three different step commands have bit 4 designated a U- bit Every 
step and change of the head appears here. 


Type 2 Commands 

These commands deal with reading and writing sectors. They also have 
individual bits with special meanings. 

BIT 76543210 

Read Sector 100MHE00 
Write Sector 101MHEPA0 

The H-bit is the previously described start-up bit. When the E-bit is set, the 
FDC waits 30 milliseconds before starting the command. This delay is 
important for some disk drives, since it takes time for the head to change 
tracks. When the E-bit reads null, the command will run immediately. 

The M-bit determines whether one or several sectors are read one after 
another. On a null reading, only one sector will be read from/ written to. 
Multi-sector reading sets the bit, and the FDC increments the counter at each 
new sector read. 

Bits 0 and 1 must be cleared for sector reading. Writing has its own special 
meaning: the A0 bit conveys to bit 0 whether a cleared or normal data 
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address mark is to be written. Most operating systems don't use this option 
(a normal data address mark is written). 

The P-bit (bit 1) dictates whether pre-compensation for writing data is 
turned on or off. Pre-compensation is normally set on; it supplies a higher 
degree of protection to the inner tracks of a diskette. 


Type 3 Commands 

Read Address gives program information about the next ID field on the 
diskette. This ID field describes track, sector, disk side and sector length. 
Read Track gives all bytes written to a formatted diskette, and the data 
"between sectors". Write Track formats a track for data storage. Here are 
the bit patterns for these commands: 


BIT 

Read Address 
Read Track 
Write Track 


76543210 

1100HE00 

1110HE00 

1111HEP0 


The H- and E-bits also belong to the Type 2 command set (spin-up and 
head-settle time). The P-bit has the same function as in writing sectors. 


.Type 4 Commands 

There’s only one command in this set: Force Interrupt This command can 
work with individual bits during another FDC command. When this 
command comes into play, whatever command was currently running is 
ended. 

BIT 76543210 

Force Interrupt 1 1 0 1 13 12 II 10 

Bits 10-13 present the conditions under which the interrupt is pressed. 10 
and II have no meaning to the 1772, and remain low. If 12 is set, an 
interrupt will be produced with every index impulse. This allows for 
software controlled disk rotation. If 13 is set, an interrupt is forced 
immediately, and the currently-running command ends. When all bits are 
null, the command ends without interruption. 
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1.4 The MFP 68901 


MFP is the abbreviation for Multi-Function Peripheral. This name is no 
exaggeration; wait until you see what it can do! Here’s a brief list of the 
most noteworthy features: 

8-bit parallel port 

Data direction of every port bit is individually programmable 

Port bits usable as interrupt input 

16 possible interrupt sources 

Four universal timers 

Built-in serial interface 


1.4.1 The 68901 Connections 


The 48 pins of the MFP are set apart in function groups. The first function 
group is the power connection set: 

GND, Vcc, CLK: 

Vcc and GND carry voltage to and from the MFP. CLK is the 
clock input; this clock signal must not interfere with the system 
timer of the processor. The ST's MFP operates at a frequency of 
4 mHz. 

Communication with the data bus of the processor is maintained with 
D0-D7, DTACK, RS1-RS5 and RESET. 

D0-D7: 

These bi-directional pins normally work with the 8 lowest data 
bits of the 68000. It is also possible to connect with D8 through 
D15, but it’s impossible to produce non-auto interrupts. Thus, 
interrupt vectors travel along the low order 8 data bits. 
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Figure 1.4-1 MFP 68901 
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CS (Chip Select): 

This line is necessary to communication with the MFP. CS is 
active when low. 

DS (Data Strobe): 

This pin works with either LDS or UDS on the processor. 
Depending on the signal, MFP will operate either the lower or 
upper half of the data bus. 

DTACK (Data Transfer ACKnoIedge): 

This signal shows the status of the bus cycle of the processor 
(read or write). 

RS1-RS5 (Register Select): 

These pins normally connect with to the bottom five address lines 
of the processor, and serve to choose from the 24 internal 
registers. 


RESET: 

If this pin is low for at least 2 microseconds, the MFP initializes. 
This occurs on power-up and a system reset. 

The next group of signals cover interrupt connections (IRQ, IACK, IEI and 
EEO). 

IRQ (Interrupt ReQuest): 

IRQ will be low when an interrupt is triggered in the MFP. This 
informs the processor of interrupts. 

IACK (Interrupt ACKnowIedge): 

On an interrupt (IRQ and IEI), the MFP sends a low signal over 
IACK and DS on the data lines. Since 16 different interrupt 
sources are available, this makes handling interrupts much 
simpler. 

IEI, IEO (Interrupt Enable In/ Out): 

These two lines permit daisy-chaining of several MFPs, and 
determine MFP priority by their positioning in this chain. IEI 
would work through the MFP with the highest priority. EEO of 
the second MFP would remain unswitched. On an interrupt, a 
signal is sent over IACK, and the first MFP in the chain will 
acknowledge with a high IEO. 
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Next, we’ll look at the eight I/O lines. 

100-7 (Input/Output): 

These pins use one or all normal I/O lines. The data direction of 
each port bit is set up in a data direction register of its own. In 
addition, though, every port bit can be programmed to be an 
interrupt input. 

The timer pins make up yet another group of connections: 

XTAL1,2 (Timer Clock Crystal): 

A quartz crystal can be connected to these lines to deliver a 
working frequency for the four timers. 

TAI.TBI (Timer Input): 

Timers A and B can not only be used as real counters differently 
from timers C and D with the frequency from XTAL1 and 2, but 
can also be set up for event counting and impulse width 
measurement In both these cases, an external signal (Timer 
Input) must be used. 

TAO,TBO,TCO,TDO (Timer Output): 

Every timer can send out its status on each peg (from 01 to 00). 
Each impulse is equal to 01. 

The second-to-last set of signals are the connections to the universal serial 
interface. The built-in full duplex of the MFP can be run synchronously or 
asynchronously, and in different sending and receiving baud rates. 

SI (Serial Input): 

An incoming bit current will go up the SI input 

SO (Serial Output): 

Outgoing bit voltage (reverse of SI). 

RC (Receiver Clock): 

Transfer speed of incoming data is determined by the frequency 
of this input; the source of this signal can, for example, be one of 
the four timers. 

TC (Transmitter Clock): 

Similar to RC, but for adjusting the baud-rate of data being 
transmitted. 
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The final group of signals aren’t used in the Atari ST. They are necessary 
when the serial interface is operated by the DMA. 

RR (Receiver Ready): 

This pin gives the status of the receiving data registers. If a 
character is completely received, this pin sends current. 

TR (Transmitter Ready): 

This line performs a similar function for the sender section of the 
serial interface. Low tells the DMA controller that a new 
character in the MFP must be sent 


1.4.2 The MFP Registers 


As we’ve already mentioned, the 68901 has a total of 24 different registers. 
This large number, together with the logical arrangement, makes 
programming the MFP much easier. 

Reg 1 GPIP, General Purpose I/O Interrupt Port 

This is the data register for the 8-bit ports, where data from the 
port bits is sent and read. 

Reg 2 AER, Active Edge Register 

When port bits are used for input, this register dictates whether 
the interrupt will be a low-high- or high-low conversion. Zero is 
used in the high-low change, one for low-high. 

Reg 3 DDR, Data Direction Register 

We’ve already said that the data direction of individual port bits 
can be fixed by the user. When a DDR bit equals 0, the 
corresponding pin becomes an input, and 1 makes it an output. 
Port bit positions are influenced by AER and DDR bits. 
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Reg 4,5 IERA,IERB, Interrupt Enable Register 

Every interrupt source of the MFP can be separately switched on 
and off. With a total of 16 sources, two 8-bit registers are 
needed to control them. If a 1 has been written to IERA or 
IERB, the corresponding channel is enabled (turned on). 
Conversely, a zero disables the channel. If it comes upon a 
closed channel caused by an interrupt, the MFP will completely 
ignore it. The following table shows which bit is coordinated 
with which interrupt occurrence: 


IERA 
Bit 7: 
Bit 6: 
Bit 5 : 
Bit 4: 
Bit 3: 
Bit 2: 
Bit 1: 
Bit 0: 


I/O port bit 7 (highest priority) 
I/O port bit 6 
Timer A 

Receive buffer full 
Receive error 
Sender buffer empty 
Sender error 
Timer B 


IERB 




Bit 

7: 

I/O 

port 

bit 

Bit 

6: 

I/O 

port 

bit 

Bit 

5: 

Timer C 


Bit 

4: 

Timer D 


Bit 

3: 

I/O 

port 

bit 

Bit 

2: 

I/O 

port 

bit 

Bit 

Is 

I/O 

port 

bit 

Bit 

0: 

I/O port 

bit 


5 

4 


3 

2 

1 

0/ lowest priority 


This arrangement applies to the IP-, IM- and IS-registers discussed below. 


Reg 6,7 IPRA,IPRB, Interrupt Pending Register 

When an interrupt occurs on an open channel, the appropriate bit 
in the Interrupt Pending Register is set to 1. When working with 
a system that allows vector creation, this bit will be automatically 
cleared when the MFP puts the vector number on the data bus. If 
this possibility doesn’t exist, the IPR must be cleared using 
software. To clear a bit, a byte in the MFP will show the location 
of the specific bit. 


The bit arrangement of the IPR is shown in the table for registers 
4 and 5 (see above). 
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Reg 8,9 ISRA,ISRB, Interrupt In-Service Register 

The function of these registers is somewhat complicated, and 
depends upon bit 3 of register 12. This bit is an S-bit, which 
determines whether the 68901 is working in ’’Software End-of- 
Interrupt" mode (SEI) or in "Automatic End-of-Interrupt" mode 
(AEI). AEI mode clears the IPR (Interrupt Pending Bit), when 
the processor gets the vector number from the MFP during an 
IACK cycle. The appropriate In-Service bit is cleared at the same 
time. Now a new interrupt can occur, even when the previous 
interrupt hasn't finished its work. 

SEI mode sets the corresponding ISR-bit when the vector 
number of the interrupt is requested by the processor. At the 
interrupt routine's end, the bit designated within the MFP must 
be cleared. As long as the Interrupt In-Service bit is set, all 
interrupts of lower priority are masked out by the MFP. Once the 
Pending-bit of the active channel is cleared, the same sort of 
interrupt can occur a second time, and interrupts of lesser priority 
can occur as well. 

Reg 10,11 IMRA,IMRB Interrupt Mask Register 

Individual interrupt sources switched on by IER can be masked 
with the help of this register. That means that the interrupt is 
recognized from within and is signalled in the IPR, even if the 
IRQ line remains high. 

Reg 12 VR Vector Register 

In the cases of interrupts, the 6890 1 can generate a vector number 
corresponding to the interrupt source requested by the processor 
during an Interrupt Acknowledge Cycle. All 16 interrupt 
channels have their own vectors, with their priorities coded into 
the bottom four bits of the vector number (the upper four bits of 
the vector are copied from the vector register). These bits must 
be set into VR, therefore. 

Bit 3 of VR is the previously mentioned S-bit. If this bit is set 
(like in the ST), then the MFP operates in "Software End-of- 
Interrupt” mode; a cleared bit puts the system into "Automatic 
End-of-Interrupt" mode. 
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Reg 13,14 TACR,TBCR Timer A/B Control Register 

Before proceeding with these registers, we should talk for a 
t moment about the timer. Timers A and B are both identical. 

Every timer consists of a data register, a programmable feature 
and an 8-bit count-down counter. Contents of the counters will 
decrease by one every impulse. When the counter stands at 01, 
the next impulse changes die corresponding timer to the output of 
its pins. At the same time, the value of the timer data register is 
loaded into the timer. If this channel is set by the IER bit, the 
interrupt will be requested. The source of the timer beats will 
usually be those quartz frequencies from XTAL1 and 2. This 
operating mode is called delay mode, and is available to timers C 
and D. 

Timers A and B can also be fed external impulses using timer 
inputs TAI and TBI (in event count mode). The maximum 
frequency on timer inputs should not surpass 1/4 of the MFP’s 
operating frequency (that is, 1 mHz). 

Another peculiarity of this operating mode is the fact that the 
timer inputs for the interrupts are I/O pins 13 and 14. By 
programming the corresponding bits in the AER, a pin-jump can 
be used by the timer inputs to request an interrupt. TAI is joined 
with pin 13, TBI by pin 14. Pins 13 and 14 can also be used as 
I/O lines without interrupt capability. 

Timers A and B have yet a third operating mode (pulse-length 
measurement). This is similar to Delay Mode, with the difference 
that the timer can be turned on and off with TAI and TBI. Also, 
when pins 13 and 14 are used, the AER-bits can determine 
whether the timer inputs are high or low. If, say, AER-bit 4 is 
set, the counter works when TAJ is high. When TAI changes to 
low, an interrupt is created. 

Now we come to TACR and TBCR. Both registers only use the 
fifth through eighth bits. Bits 0 to 3 determine the operating 
mode of each timer: 
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BIT 3210 Function 

0000 Timer stop, no function executed 

0001 Delay mode, subdivider divides by 4 

0010 Delay mode, subdivider divides by 10 

0011 Delay mode, subdivider divides by 16 
0011 Delay mode, subdivider divides by 16 

0100 Delay mode, subdivider divides by 50 

0101 Delay mode, subdivider divides by 64 

0110 Delay mode, subdivider divides by 100 

0111 Delay mode, subdivider divides by 200 

1000 Event Count Mode 

1001 Pulse extension mode, subdivider divides by 4 

1010 Pulse extension mode, subdivider divides by 10 

1011 Pulse extension mode, subdivider divides by 16 

1100 Pulse extension mode, subdivider divides by 50 

1101 Pulse extension mode, subdivider divides by 64 

1110 Pulse extension mode, subdivider divides by 100 

1111 Pulse extension mode, subdivider divides by 200 

Bit 4 of the Timer Control Register has a particular function. 
This bit can produce a low reading for the timer being used with 
it at any time. However, it will immediately go high when the 
timer runs. 


Reg 15 TCDCR Timers C and D Control Register 

Timers C and D are available only in delay mode; thus, one byte 
controls both timers. The control information is programmed 
into the lower three bits of the nibbles (four- bit halves). Bits 0 
and 2 arrange Timer D, Timer C is influenced by bits 4 and 6. 
Bits 3 and 7 in this register have no function. 


2 

1 
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Reg 16-19 TADR,TBDR,TCDR,TDDR Timer Data Registers 

The four Timer Data Registers are loaded with a value from the 
counter. When a condition of 01 is reached, an impulse occurs. 
A continuous countdown will stem from this value. 

Reg 20 SCR Synchronous Character Register 

A value will be written to this register by synchronous data 
transfer, so that the receiver of the data will be alerted. When 
synchronous mode is chosen, all characters received will be 
stored in the SCR, after first being put into the receive buffer. 

Reg 21 UCR,USART Control Register 

USART is short for Universal Synchronous/Asynchronous 
Receiver/Transmitter. The UCR allows you to set all the 
operating parameters for the interfaces. Parameters can also be 
coded in with the timers. 

Bit 0 : unused 

Bit 1 : 0=Odd parity 

l=Even parity 

Bit 2 : 0=No parity (bit 1 is ignored) 

l=Parity according to bit 1 

Bits 3,4 : These bis control the number of 

start- and stopbits and the 
format desired. 

Bit 4 3 Start Stop Format 

000 0 Synchronous 

011 1 Asynchronous 

10 1 1,5 Asynchronous 

111 2 Asynchronous 

Bits 5,6 : These bits give the 

"wordlength" of the data bits 
to be transferred. 

Bits 6 5 Word length 
008 bits 
017 bits 
106 bits 
115 bits 
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Bit 7 : 0=Frequency from TC and RC 

directly used as transfer 
frequency (used only for 
synchronous transfer) 
l=Frequency in TC and RC 
internally divided by 16. 

Reg 22 RSR Receiver Status Register 

The RSR gives information concerning the conditions of all 
receivers. Again, the different conditions are coded into 
individual bits. 

Bit 0 Receiver Enable Bit 

When this bit is cleared, receipt is immediately turned off. 
All flags in RSR are automatically cleared. A set bit means 
that the receiver is behaving normally. 

Bit 1 Synchronous Strip Enable 

This bit allows synchronous data transfer to determine 
whether or not a character in the SCR is identical to a 
character in the receive buffer. 

Bit 2 Match/Character in Progress 

When in synchronous transfer format, this bit signals that a 
character identical with the SCR byte would be received. 
In asynchronous mode, this bit is set as soon as the startbit 
is recognized. A stopbit automatically clears this bit. 

Bit 3 Found - Search/Break Detected 

This bit is set in synchronous transfer format, when a 
character received coincides with one stored in the SCR. 
This condition can be treated as an interrupt over the 
receiver's error channel. Asynchronous mode will cause 
the bit to set when a BREAK is received. The break 
condition is fulfilled when only zeroes are received 
following a startbit. To distinguish between a BREAK 
from a "real” null, this line should be low. 

Bit 4 Frame Error 

A frame error occurs when a byte received is not a null, but 
the stopbit of the byte IS a null. 
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Bit 5 Parity Error 

The condition of this bit gives information as to whether 
parity on the last received character was correct. If the 
parity test is off, the PE bit is untouched. 

Bit 6 Overrun Error 

This bit will be set when a complete character is in the 
receiver floating range but not read into the receive buffer. 
This error can be operated as an interrupt. 

Bit 7 Buffer Full 

This bit is set when a character is transferred from the 
floating register to the receive buffer. As soon as the 
processor reads the byte, the bit is cleared. 

Reg 23 TSR Transmitter Status Register 

Whereas the RSR sends receiver information, the TSR handles 
transmission information. 

Bit 0 T ransmitter Enable 

The sending section is completely shutoff when this bit is 
cleared. At the same time the End-bit is cleared and the UE- 
bit is set (see below). The output to the receiver is set in 
the corresponding H- and L-bits. 

Bits 1,2 High- and Low-bit 

These bits let the programmer decide which mode of output 
the switched-off transmitter will take on. If both bits are 
cleared, the output is high. High-bit only will create high 
output; low-bit, low output. Both bits on will switch on 
loop-back-mode. This state loops the output from the 
transmitter with receiver input. The output itself is on the 
high-pin. 

Bit 3 Break 

The break-bit has no function in synchronous data transfer. 
In asynchronous mode, though, a break condition is sent 
when the bit is set 
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Bit 4 End of Transmission 

If the sender is switched off during running transmission, 
the end-bit will be set as soon as the cuirent character has 
been sent in its entirety. When no character is sent, the bit 
' is immediately set. 

Bit 5 Auto Turnaround 

When this bit is set, the receiver is automatically switched 
on when the transmitter is off, and a character will 
eventually be sent. 

Bit 6 Underrun Error 

This bit is switched on when a character in the sender 
floating register will be sent, before a new character is 
written into the send buffer. 

Bit 7 Buffer Empty 

This bit will be set when a character from the send buffer 
will be transferred to the floating register. The bit is 
cleared when new data is written to the send buffer. 

Reg 24 UDR, USART Data Register 

Send/receive data is sent over this register. Writing sends data in 
the send buffer, reading gives you the contents of the receive 
buffer. 
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1.5 The 6850 ACIAs 


ACIA is short for "Asynchronous Communications Interface Adapter". 
This 24-pin IC has all the components necessary for operating a serial 
interface, as well as error-recognizing and data-formatting capabilities. 
Originally for 6800-based computers, this chip can be easily tailored for 
6502 and 68000 systems. The ST has two of these chips. One of them 
communicates with the keyboard, mouse, joystick ports, and runs the 
clock. Keyboard data travels over a serial interface to die 68000 chip. The 
second ACIA is used for operating the MIDI interface. 

Parameter changes in the keyboard ACIA are not recommended: The 
connection between keyboard and ST can be easily disrupted. The MIDI 
interface is another story, though — we can create all sorts of practical 
applications. Incidentally, nowhere else has it been mentioned that the 
MIDI connections can be used for other purposes. One idea would be to 
use the MIDI interfaces of several STs to link them together (for schools or 
offices, for example). 


1.5.1 The Pins of the 6850 


For those of you readers who aren’t very well-acquainted with the 
principles of serial data transfer, we've included some fairly detailed 
descriptions in the pin layout which follows. 

Yss 

This connection is the "ground wire" of the IC. 

RX DATA Receive Data . 

This pin receives data; a start-bit must precede the least significant 
data-bit before receipt. 
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Figure 1.5-1 ACIA 6850 
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RX CLK Receive Clock 

This pin signal determines baud-rate (speed at which the data is 
received), and is synchronize to the incoming data. The 
frequency of RX CLK is patterned after the desired transfer 
speed and after the internally programmed division rate. 

TX CLK Transmitter Clock 

Like RX CLK, only used for transmission speed. 

RTS Request To Send 

This output signals the processor whether the 6850 is low or 
high; mostly used for controlling data transfer. A low output 
will, for example, signal a modem that the computer is ready to 
transmit. 

TX DATA Transmitter Data 

This pin sends data bit-wise (serially) from the computer. 

IRQ Interrupt Request 

Different circumstances set this pin low, signaling the 68000 
processor. Possible conditions include completed transmission 
or receipt of a character. 

CS 0,1,2 Chip Select 

These three lines are needed for ACIA selection. The relatively 
high number of CS signals help minimize the amount of 
hardware needed for address decoding, particularly in smaller 
computer systems. 

RS Register Select 

This signal communicates with internal registers, and works 
closely with the RAV signal. We shall talk about these registers 
later. 

Vcc Voltage 

This pin is required of all ICs - this pin gets an operating voltage 
of 5V. 

RAV ReadAVrite 

This tells the processor the "direction" of data traveling through 
the ACIA. A high signal tells the processor to read data, and low 
writes data in the 6850. 
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E Enable 

The E-signal determines the time of reading/writing. All 
read/write processes with this signal must be synchronous. 

DO - D7 Data 

These data lines are connected to those of the 68000. Until the 
ACIA is accessed, these bidirectional lines are ail high. 

DCD Data Carrier Detect 

A modem control signal, which detects incoming data. When 
DCD is high, serial data cannot be received. 

CTS Clear To Send 

CTS answers the computer on the signal RTS. Data transmission 
is possible only when this pin is low. 


1.5.2 The Registers of the 6850 


The 6850 has four different registers. Two of these are read only. Two of 
them are write only. These registers are distinguished by R/W and RS, 
after the table below: 


R/ W ,BwL 

0 0 

0 1 

1 0 

1 1 


Register 

Control Register 
Sender Register 
Status Register 
Receive Register 


Access 

write 

write 

read 

read 


The sender/receiver registers (also known as the RX- and TX- buffers) are 
for data transfer. When receiving is possible, the incoming bits are put in a 
shift register. Once the specified number of bits has arrived, the contents of 
the shift register are transferred to the TX buffer. The sender works in 
much the same way, only in the reverse direction (RX buffer to sender shift 
register). 
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The Control Register 

The eight-bit control register determines internal operations. To solve the 
problem of controlling diverse functions with one byte, single bits are set up 
as below: 

CR 0,1 

These bits determine by which factor the transmitter and receiver 
clock will be divided. These bits also are joined with a master 
reset function. The 6850 has no separate reset line, so it must be 
accomplished through software. 

CR1 CRO 

0 0 RXCLK/TXCLK without division 

0 1 RXCLK/TXCLK by 16 (for MIDI) 

1 0 RXCLK/TXCLK by 64 (for keyboard) 

1 1 Master RESET 

CR 2,3,4 

These so-called Word Select bits tell whether 7 or 8 data-bits are 
involved; whether 1 or 2 stop-bits are transferred; and the type of 
parity. 

CR4 CR3 CR2 

0 0 0 

0 0 1 

0 10 
Oil 
10 0 
10 1 
110 
111 

CR 6,5 

These Transmitter Control bits set the RTS output pin, and allow 
or prevent an interrupt through the ACIA when the send register 
is emptied. Also, BREAK signals can be sent over the serial 
output by this line. A BREAK signal is nothing more than a long 
sequence of null bits. 


7 databits, 2 stopbits, even parity 
7 databits, 2 stopbits, odd parity 
7 databits, 1 stopbit, even parity 

7 databits, 1 stopbit, odd parity 

8 databits, 2 stopbit, no parity 
8 databits, 1 stopbit, no parity 
8 databits, 1 stopbit, even parity 
8 databits, 1 stopbit, odd parity 


45 



Abacus Software 


Atari ST Internals 


CR6 

0 

0 

1 

1 


CR5 

0 RTS low, transmitter IRQ disabled 

1 RTS low, transmitter IRQ enabled 

0 RTS high, transmitter IRQ disabled 

1 RTS low, transmitter IRQ disabled, BREAK 
sent 


CR 7 

The Receiver Interrupt Enable bit determines whether the receiver 
interrupt will be on. An interrupt can be caused by the DCD line 
changing from low to high, or by the receiver data buffer filling. 
Besides that, an interrupt can occur from an OVERRUN (a 
received character isn't properly read from the processor). 


CR7 

0 Interrupt disabled 

1 Interrupt enabled 


The Status Register 

The Status Register gives information about the status of the chip. It also 
has its information coded into individual bytes. 

SRO 

When this bit is high, the RX data register is full. The byte must 
be read before a new character can be received (otherwise an 
OVERRUN happens). 

SRI 

This bit reflects the status of the TX data buffer. An empty 
register sets the bit. 

SR2 

A low-high change on pin DCD sets SR2. If the receiver 
interrupt is allowable, the IRQ will be cancelled. The bit is 
cleared when the status register and the receiver register are read. 
This also cancels the IRQ. SR2 register remains high if the 
signal on the DCD pin is still high; SR2 registers low if DCD 
becomes low. 
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SR3 

This line shows the status of CTS. This signal cannot be altered 
by a master reset, or by ACIA programming. 

SR4 

Shows "Frame errors". Frame errors are when no stop-bit is 
recognized in receiver switching. It can be set with eveiy new 
character. 

SR5 

This bit displays the previously mentioned OVERRUN 
condition. SR5 is reset when the RX buffer is read. 

SR6 

This bit recognizes whether the parity of a received character is 
correct. The bit is set on an error. 

SR 7 

This signals the state of the IRQ pins; this bit makes it possible to 
switch several IRQ lines on one interrupt input. In cases where 
an interrupt is program-generated, SR7 can tell which IC cut off 
the interrupt. 


The ACIAs in the ST 

The ACIAs have lots of extras unnecessary to the ST. In fact, CTS, DCD 
and RTS are not connected. 

The keyboard ACIA lies at the addresses SFFFCOO and $FFFC02. Built-in 
parameters are: 8-bit word, 1 stopbit, no parity, 7812.5 baud (500 
kHz/64). 

The parameters are the same for the MIDI chip, EXCEPT for the baud rate, 
which runs at 31250 baud (500 kHz/ 16). 
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1.6 The YM-2149 Sound Generator 


The Yamaha YM-2149, a PSG (programmable sound generator) in the same 
family as the General Instruments AY-3-8190, is a first-class sound 
synthesis chip. It was developed to produce sound for arcade games. The 
PSG also has remarkable capabilities for generating/altering sounds. 
Additionally, the PSG can be easily controlled by joysticks, the computer 
keyboard, or external keyboard switching. The PSG has two bidirectional 
8-bit parallel ports. Here’s some general data on the YM-2149: 

• three independently programmable tone generators 

• a programmable noise generator 

• complete software-controlled analog output 

• programmable mixer for tone/noise 

• 15 logarithmically raised volume levels 

• programmable envelopes (A SDR) 

• two bidirectional 8-bit data ports 

• TTL-compadble 

• simple 5-volt power 

The YM-2149 has a total of 16 registers. All sound capabilities are 
controlled by these registers. 

The PSG has several "functional blocks" each with its own job. The tone 
generator block produces a square-wave sound by means of a time signal. 
The noise generator block produces a frequency-modulated square-wave 
signal, whose pulse-width simulates a noise generator. The mixer couples 
the three tone generators' output with the noise signal. The channels may 
be coupled by programming. 

The amplitude control block controls the output volume of the three 
channels with the volume registers; or creates envelopes (Attack, Decay, 
Sustain, Release, or ADSR), which controls the volume and alters the 
sound quality. 

The D/A converter translates the volume and envelope information into 
digital form, for external use. Finally one function block controls the two 
I/O ports. 
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Figure 1.6-1 Sound chip YM-2149 
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1.6.1 Sound Chip Pins 


Vss: 

This is the PSG ground connection. 

NC.: 

Not used. 

ANALOG B: 

This is the channel B output Maximum output voltage is 1 vss. 
ANALOG A: 

Works like pin 3, but for channel A. 

NC.: 

Not used. 

IOB7 - 0: 

The IOB connections make up one of the two 8-bit ports on the 
chip. These pins can be used for either input or output. Mixed 
operation (input and output combined) is impossible within one 
port, however both ports are independent of one another. 

IOA7 - 0: 

Like IOB, but for port A. 

CLOCK: 

All tone frequencies are divided by this signal. This signal 
operates at a frequency between I and 2 mHz. 


RESET: 

A low signal from this pin resets all internal registers. Without a 
reset, random numbers exist in all registers, the result being a 
rather unmusical "racket". 


This pin acts as a chip select-signal. When it is low, the PSG 
registers are ready for communication. 


50 



Abacus Software 


Atari ST Internals 


A8: 

Similar to A9, only it is active when high. 


TEST2: 

Test2 is used for testing in the factory, and is unused in normal 
operation. 

BDIR & BC1,2: 

The BDIR (Bus DIRection), BC1 and BC2 (Bus Control) pins 
control the PSG’s register access. 


BDIR BC2 BCl 

0 0 0 

0 0 1 

0 10 

Oil 
10 0 
10 1 
110 
111 


PSG function 
Inactive 
Latch address 
Inactive 
Read from PSG 
Latch address 
Inactive 
Write to PSG 
Latch address 


Only four of these combinations are of any use to us; those with a 
5+ voltage running over BC2. So, here’s what we have left: 


BP_I.B_B.C1 . FhJlC.t iL>n 

0 0 Inactive, PSG data bus high 

0 1 Read PSG registers 

1 0 Write PSG registers 

1 1 Latch, write register number (s) 

DAO - 7: 

These pins connect the sound chip to the processor, through the 
data bus. The identifier DA means that both data and (register) 
addresses can be sent over these lines. 

ANALOG C: 

Works with channel C (see ANALOG B, above). 


TEST1: 

See TEST2. 


Vcc: 

+5 volt pin. 
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1.6.2 The 2149 Registers and their Functions 


Now let's look at the functions of the individual registers. One point of 
interest: the contents of the address register remain unaltered until 
reprogrammed. You can use the same data over and over, without having 
to send that data again. 

Reg 0,1: 

These register determine the period length, and the pitch of 
ANALOG A. Not all 16 bits are used here; the eight bits of 
register 0 (set frequency) and the four lowest bits of register 1 
(control step size). The lower the 12-bit value in the register, the 
higher the tone. 


Reg 2,3: 

Same as registers 0 and 1, only for channel B. 

Reg 4,5: 

Same as registers 0 and 1, only for channel C. 


Reg 6: 

The five lowest bits of this register control the noise generator. 
Again, the smaller the value, the higher the noise "pitch". 

Reg 7: 


Bit 

0 : Channel 

A 

tone on/off 

0=on 

/l=off 

Bit 

1 : Channel 

B 

tone on/off 

0=on 

/l=off 

Bit 

2 : Channel 

C 

tone on/off 

0=on 

/l=off 

Bit 

3 : Channel 

A 

noise on/off 

0=on 

/1-off 

Bit 

4 : Channel 

B 

noise on/off 

0=on 

/1-off 

Bit 

5 : Channel 

C 

noise on/off 

0-on 

/l=off 

Bit 

6: Port A 

in /output 

0=in 

/1-out 

Bit 

7: Port B 

in/output 

0=in 

/l— out 
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Figure 1.6-2 Envelopes of the PSG 
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Reg 8: 

Bits 0-3 of this register contrrol the signal volume of channel A. 
When bit 4 is set, the envelope register is being used and the 
contents of bits 0-3 are ignored 

Reg 9: 

Same as register 8, but for channel B. 

Reg 10: 

Same as register 8, but for channel C. 

Reg 11,12: 

The contents of register 1 1 are the low-byte and the contents of 
register 12 are the high-byte of the sustain. 


Reg 13: 

Bits 0-3 determine the waveform of the envelope generator. The 
possible envelopes are pictured in Figure 1.6-2. 

Reg 14,15: 

These registers comprise the two 8-bit ports. Register 14 is 
connected to Port A and register 15 is connected to Port B. If 
these ports are programmed as output (bits 7 and 8 of register 7) 
then values may be sent through these registers. 
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1.7 I/O Register Layout in the ST 


The entire I/O range (all peripheral ICs and other registers) is controlled by a 
32K address register — SFF8000 - $FFFFFF. Below is a complete table of 
the different registers. CAUTION: The I/O section can be accessed only in 
supervisor mode. Any access in user mode results in a bus-error. 


$FF8000 

$FF8200 

$FF8400 

$FF8600 

$FF8800 

$FFFA00 

$FFFC00 


Memory configuration 
Video display register 
Reserved 

DMA/disk controller 
Sound chip 
MFP 68901 

ACIAs for MIDI and keyboard 


The addresses given refer only to the start of each register, and supply no 
hint as to the size of each. More detailed information follows. 


$FF80QQ Memory Co n figurati o n 

There is a single 8-bit register at $FF8001 in which the memory 
configuration is set up (four lowest bits). The MMU-IC is designed for 
maximum versatility within the ST. It lets you use three different types of 
memory expansion chips: 64K, 256K, and die 1M chips. Since all of these 
ICs are bit-oriented instead of byte-oriented, 16 memory chips of each type 
are required for memory expansion. The identifier for 16 such chips 
(regardless of memory capacity) is BANK. So, expansion is possible to 
128 Kbyte, 512 Kbyte or even 2 Megabytes. 

MMU can control two banks at once, using the RAS- and CAS- signals. 
The table on the next page shows the possible combinations: 
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SPF8001 


Ri t 

Memory 

conf iauration 

3-0 

Bank 0 

Bank 1 

0000 

128K 

128K 

0001 

128K 

512K 

0010 

128K 

2 M 

0011 

reserved 

0100 

512K 

128K 

0101 

512K 

512K 


0100 

512K 

2 M, normally reserved 

0100 

reserved 


1000 

2M 

128K 

1001 

2M 

512K 

1010 

2M 

2M 

1011 

reserved 


11XX 

reserved 



The memory configuration can be read from or written to. 


$FF820Q Video Display Register 

This register is the storage area that determines the resolution and the color 
palette of the video display. 

$FF8201 8-bit Screen memory position (high-byte) 
$FF8203 8-bit Screen memory position (low-byte) 

These two read/write registers are located at the beginning of the 32K video 
RAM. 

In order to relocate video RAM, another register is used. This register is 
three bytes long and is located at $FF8205. Video RAM can be relocated in 
256-byte incremeents. Normally the starting address of video RAM is 
$78000. 

$FF8205 8-bit Video address pointer (high-byte) 

$FF8207 8-bit Video address pointer (mid-byte) 

$FF8209 8-bit Video address pointer (low-byte) 

These three registers are read ONLY. Every three microseconds, the 
contents of these registers are incremented by 2. 
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$FF820A BIT Synchronization mode 

1 0 

: : — 0=internal f l=external synchronization 
; 0=60 Hz, l=50Hz screen frequency 

The bottom two bits of this register control synchronization mode; the 
remaining bits are unused. If bit 0 is set, the HSync and VSync impulses 
are shut off, which allows for semen synchronization from external sources 
(monitor jack). This offers new realm of possibilities in video, 
synchronization of your ST and a video camera, for example. 

Bit 1 of the sync-mode register handles the screen frequency. This bit is 
useful only in the two "lowest” resolutions. High-res operation puts the ST 
at a 70 Hz screen frequency. 

Sync mode can be read/written. 


$FF8240 

16-bit 

Color 

palette 

register 

0 

$FF8242 

16-bit 

Color 

palette 

• 

register 

1 



Color 

■ 

palette 

• 

registers 

2-13 

$FF825C 

16-bit 

Color 

palette 

register 

14 

$FF825E 

16-bit 

Color 

palette 

register 

15 


Although the ST has a total of 512 colors, only 16 different colors can be 
displayed on the screen at one time. The reason for this is that the user has 
16 color pens on screen, and each can be one of 512 colors. The color 
palette registers represent these pens. All 16 registers contain 9 bits which 
affect the colon 

FEDCBA9876543210 
XXX . XXX . XXX 

The bits marked X control the registers. Bits 0-2 adjust the shade of blue 
desired; 4-6, green hue; and 8-A, red. The higher the value in these three 
bits, the more intense the resulting color. 

Middle resolution (640 X 200 points) offers four different colors; colors 4 
through 15 are ignored by the palette registers. 

When you want the maximum of 16 colors, it’s best to zero-out the contents 
of the palette registers. 
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High-res (640 X 400 points) gives you a choice on only one "color"; bit 0 
of palette register 0 is set to the background color. If the bit is cleared, then 
the text is black on a light background. A set bit reverses the screen (light 
characters, black background). The color register is a read/write register. 


$FF8260 


Bit Resolution 
1 0 

0 0 320 X 200 points, four focal planes 

0 1 640 X 200 points, two focal planes 

1 0 640 X 400 points, one focal planes 


This register sets up the appropriate hardware for the graphic resolution 
desired. 


$FF860Q DMA/Disk Controller 

$FF8600 reserved 

$FF8602 reserved 

$FF8604 16-bit FDC access/sector count 

The lowest 8 bits access the FDC registers. The upper 8 bits contain no 
information, and consistently read 1. Which register of the FDC is used 
depends upon the information in the DMA mode control register at 
$FF8606. The FDC can also be accessed indirectly. 

The sector count-register under $FF8604 can be accessed when the 
appropriate bit in the DMA control register is set. The contents of these 
addresses are both read/write. 

$FF8606 16-bit DMA mode/status 

When this register is read, the DMA status is found in the lower three bits of 
the register. 

Bit 0 0=no error, 1=DMA error 

Bit 1 0=sector count = null, l=sector count Onull 
Bit 2 Condition of FDC DATA REQUEST signal 

Write access to this address controls the DMA mode register. 
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Bit 0 

unused 


Bit 1 

0=pin AO is low 
l=pin AO is high 


Bit 2 

Q=pin A1 is low 
l=pin A1 is high 


Bit 3 

0=FDC access 
1=HDC access 


Bit 4 

Q=access to FDC register 



l=access to sector count register 

Bit 5 

0, reserved 


Bit 6 

0=DMA on 
l=no DMA 


Bit 7 

0=hard disk controller access 
1=FDC access 

(HDC) 

Bit 8 

0=read FDC/HDC registers 
l=write to FDC/HDC registers 


$FF860 9 

8-bit DMA basis and counter 

high-byte 

$FF860B 

8-bit DMA basis and counter 

mid-byte 

$FF860D 

8-bit DMA basis and counter 

low-byte 


DMA transfer will tell the hardware at which address the data is to be 
moved. The initialization of the three registers must begin with the low-byte 
of the address, then mid-byte, then high-byte. 


$EE8800 Sound Chip 

The YM-2149 has 16 internal registers which can’t be directly addressed. 
Instead, the number for the desired register is loaded into the select register. 
The chosen registers can be read/write, until a new register number is 
written to the PSG. 

$FF88Q0 8-bit Read data/Register select 

Reading this address gives you the last register used (normally port A), by 
which disk drive is selected. This can be accomplished with write-protect 
signals, although these protected contents can be accessed by another 
register. Port A is used for multiple control functions, while port B is the 
printer data port. 
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PORT A 


Bit 

0 

Page-choice signal for double-sided 
floppy drive 

Bit 

1 

Drive select signal — floppy drive 0 

Bit 

2 

Drive select signal — floppy drive 1 

Bit 

3 

RS-232 RTS-output 

Bit 

4 

RS-232 DTR output 

Bit 

5 

Centronics strobe 

Bit 

6 

Freely usable output (monitor jack) 

Bit 

7 

reserved 


When $FF8800 is written to, the select register of the PSG is alerted. The 
information in the bottom four bits are then considered as register numbers. 
The necessary four-bit number serves for writing to the PSG. 

$FF8802 8-bit Write data 

Attempting to read this address after writing to it will give you $FF only, 
while BDIR and BC 1 are nulls. 

Writing register numbers and data can be performed with a single MOVEP 
instruction. 

SFEEAflQ MFP 68901 

The MFP’s 24 registers are found at uneven addresses from 
$FFFA0 1 -$FFFA2F: 


$FFFA01 

8-bit 

Parallel port 

$FFFA03 

8-bit 

Active Edge register 

$FFFA05 

8-bit 

Data direction 

$FFFA07 

8-bit 

Interrupt 

enable A 

$FFFA09 

8-bit 

Interrupt 

enable B 

$FFFA0B 

8 -bit 

Interrupt 

pending A 

$FFFA0D 

8-bit 

Interrupt 

pending B 

$FFFA0F 

8-bit 

Interrupt 

in-service A 

$FFFA11 

8-bit 

Interrupt 

in-service B 

$FFFA13 

8-bit 

Interrupt 

mask A 

$FFFA15 

8-bit 

Interrupt 

mask B 

$FFFA17 

8-bit 

Vector register 

$FFFA19 

8-bit 

Timer A control 

$FFFA1B 

8-bit 

Timer B control 
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$FFFA1D 

8 -bit 

$FFFA1F 

8-bit 

$FFFA2 1 

8 -bit 

$FFFA23 

8-bit 

$FFFA25 

8-bit 

$FFFA27 

8 -bit 

$FFFA2 9 

8-bit 

$FFFA2B 

8-bit 

$FFFA2D 

8-bit 

$FFFA2F 

8-bit 


Timer C & D control 
Timer A data 
Timer B data 
Timer C data 
Timer D data 
Sync character 
USART control 
Receiver status 
Transmitter status 
USART data 


See the chapter on the MFP for details on the individual registers. 


I/O Port 
Bit 0 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bit 6 
Bit 7 


Centronics busy 

RS-232 data carrier detect - input 
RS-232 clear to send - input 
reserved 

keyboard and MIDI interrupt 
FDC and HDC interrupt 
RS-232 ring indicator 
Monochrome monitor detect 


Timers A and B each have an input which can be used by external timer 
control, or send a time impulse from an external source. Timer A is unused 
in the ST, which means that the input is always available, but it isn't 
connected to the user port, so the Centronics busy pin is connected instead. 
You can use it for your own purposes. 

Timer B is used for counting screen lines in conjunction with DE (Display 
Enable). 


The timer outputs in A-C are unused. Timer D, on the other hand, sends 
the timing signal for the MFP’s built-in serial interface. 


61 


Abacus Software 


Atari ST Internals 


$EEE£M K ey boar d afl.d.Jffl P .LMIl&s 

The communications between the ST, the keyboard, and musical 
instruments are handled by two registers in the ACIAs. 


$FFFC00 8-bit 
$FFFC02 8-bit 
$FFFC04 8-bit 
$FFFC0 6 8-bit 


Keyboard AC I A control 
Keyboard ACIA data 
MIDI ACIA control 
MIDI ACIA data 


Figure 1.7-1 I/O Assignments 


SFFFCOO 

JFFFAOO 


2 ACLV s 6580 


MFP 68901 


SFF8800 

$FF8600 

SFF8400 

SFF8200 

SFF8000 


SOUND AY-3-8910 


DMA / WD 1770 


RESERVED 

VIDEO CONTROLLER 


DATA CONFIGURATION 
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Figure 1.7-2 Memory Map of the ATARI ST 


$FF FCOO 

$FF FflOO 

$FF 8800 
8600 
8400 
8200 
$FF 8000 



16776192 

16775680 

16746496 
16745984 
16745472 
1 6744960 
1 6744448 


$FE FFFF 

$FC 0000 

$Fft 0000 
$07 FFFF 

$00 0000 


192 K 

System ROM 


128 K ROM 
Expansion Cartridge 


512 K RAM 


16711679 


16515072 


16384000 

524287 


0 
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The Interfaces 


2.1 The Keyboard 


Do you think it’s really necessary to give a detailed report on something as 
trivial as the keyboard, since keyboards all function the same way? Actually 
the title should read "Keyboard Systems" or something similar. The 
keyboard is controlled by its own processor. You will soon see how this 
affects the assembly language programmer. 

The keyboard processor is single-chip computer (controller) from the 6S00 
family, the 6301. Single chip means that everything needed for operation is 
found on a single IC. In actuality, there are some passive components in the 
keyboard circuit along with the 6301. 

The 6301 has ROM, RAM, some I/O lines, and even a serial interface on 
the chip. The serial interface handles the traffic to and from the main board. 

The advantage of this design is easy to see. The main computer is not 
burdened by having to continually poll the keyboard. Instead it can dedicate 
itself completely to processing your programs. The keyboard processor 
notifies the system if an event occurs that the operating system should be 
aware of. 

The 6301 is not only responsible for the relatively boring task of reading the 
keyboard, however. It also takes care of the rather complicated tasks 
required in connection with the mouse. The main processor is then fed 
simply the new X and Y coordinates when the mouse is moved. Naturally, 
anything to do with the joysticks is also taken care of by the keyboard 
controller. 

In addition, this controller contains a real-time clock which counts in 
one-second increments. 
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Figure 2.1-1 6850 Interface to 68000 
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In Figure 2. 1-1 is an overview of the interface to the 68000. As you see, the 
main processors is burdened as little as possible. The ACIA 6850 ensures 
that it is disturbed only when a byte has actually been completely received 
from the keyboard. The ACIA, by the way, can be accessed at addresses 
$FFFC00 (control register) and $FFFC02 (data register). The individual 
connection to the keyboard takes place over lines K14 and K15. K indicates 
the plug connection by which the keyboard is connected to the main board. 

The signal that the ACIA has received a byte is first sent over line 14 to the 
MFP 68901 which then generates an interrupt to the 68000. The clock 
frequency of 500KHz comes from GLUE. From this results the "odd" 
transfer rate of 78 12.5 baud. 

In case you were surprised that data can also be sent to the keyboard 
processor, you will find the solution to the puzzle in Chapter 2.1.2. 

The block diagram of the keyboard circuit is found in Figure 2.1-2. The 
function is as simple as the figure is easy to read. The processor has 4K of 
ROM available. The 128 bytes of RAM is comparitively small, but it is used 
only as a buffer and for storing pointers and counters. 

The lines designated with K are again the plug connections assigned to the 
main board. With few exceptions, the connections for the joystick and 
mouse are also put through. K16 is the reset line from the 68000. K15 
carries the send data from the 6850, K 14 the send data from the 6301. 

The I/O ports 1(0-7), 3(1-7), and 4(0-7) are responsible for reading the 
keyboard matrix. One line from ports 3 and 4 is pulled low in a cycle. The 
state of port 1 is the checked. If a key is pressed, the low signal comes 
through on port 1. 

Each key can be identified from the combination of value placed on ports 3 
and 4 and the value read from port 1. 

If none of the lines of Port 3 and 4 are placed low and a bit of port 1 still 
equals zero, a joystick is active on the outer connecter 1 . The data from 
outer connector 0, to which a mouse or a joystick can be connected, does 
not come through by chance since it must first be switched through the 
NAND gate with port 2 (bit 0). The buttons on the mouse or the joystick 
then arrive at port 2(1 and 2). 
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The assignments of the K lines to the signal names on the outer connecter 
are found in the next section. 

The processor 6301 is completely independent, but it can also be configured 
so that it works with an external ROM. Some of the port lines are then 
reconfigured to act as address lines. The configuration the processor 
assumes (one of eight possibilities) depends on the logical signal placed on 
port 2 (bits 0-2) during the reset cycle. All three lines high puts the 
processor in mode 7, the right one for the task intended here. But bits 1 and 
2 depend on the buttons on the mouse. If you leave the mouse alone while 
powering-up, everything will be in order. If you hold the two buttons 
down, however, the processors enters mode 1 and makes a magnificent 
belly-flop, since the hardware for this operating mode is not provided. You 
notice this by the fact that the mouse cursor does not move on the screen if 
you move the mouse. Only the reset button will restore the processor. 


2.1.1 The Mouse 


The construction of this little device is quite simple, but effective. 
Essentially, it consists of four light barriers, two encoder wheels, and a 
drive mechanism. 

The task of the mouse is to give the computer information about its 
movements. This information consists of the components: direction on the 
X-axis, direction on the Y-axis, and the path traveled on each axis. 

In order to do this, the rubber-covered ball visible from the outside drives 
two encoder wheels whose drive axes are at angle of 90 degrees to each 
other. The one or the other axis rotates more or less, forwards or 
backwards, depending on the direction the mouse is moved. 

It is no problem to determine the absolute movement on each axis. The 
encoder wheels alternately interrupt the light barriers. One need only count 
the pulses from each wheel to be informed about the path traveled on each 
axis. 
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It is more difficult when the direction of movement is also required. The 
designers of the mouse used a convenient trick for this. There are not one, 
but two light barriers on each encoder wheel. They are arranged such that 
they are not shielded by the wheel at precisely the same time, but one 
shortly after the other. This arrangement may not be so clear in Figure 
2.1 .1-1, so we'll explain it in more detail The direction can be determined 
by noticing which of the two light barriers is interrupted first. This is why 
the pulses from both light barriers are sent out, making a total of four. 
Corresponding to their significance they carry the names XA, XB, YA, YB. 

The two contacts which you see on the picture represent the two buttons. 

The large box on the picture is a quad operational amplifier which converts 
the rather rough light-barrier pulses into square wave signals. 

In Figure 2. 1.1-2 is the layout of the control port on the computer, as you 
see it when you look at it from the outside. The designation behind the slash 
applies when a joystick is connected and the number in parentheses is the 
pin number of the keyboard connector. 

PortO 


1 

XB/UP 

(K12) 

2 

XA/DOWN 

(K10) 

3 

Y A/LEFT 

(K9) 

4 

YB/RIGHT 

(K8) 

6 

LEFT BUTTON/FIRE 

(Kll) 

7 

+5V 

(K13) 

8 

GND 

(Kl) 

9 

RIGHT BUTTON 

(K6) 

Port 1 

1 

UP 

(K7) 

2 

DOWN 

(K5) 

3 

LEFT 

(K4) 

4 

RIGHT 

(K3) 

5 

Port 0 enable 

(XI 7) 

6 

FIRE 

(K6) 

7 

+5V 

(K13) 

8 

GND 

(Kl) 
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Figure 2.1.1-2 Mouse control port 



2.1.2 Keyboard commands 


The keyboard processor "understands" some commands pertaining to such 
things as how the mouse is to be handled, etc. You can set the clock time, 
read the internal memory, and so on. You can find an application example in 
the assembly language listing on page 80 (after command $21). 

The "normal" action of the processor consists of keeping an eye on the 
keyboard and announcing each keypress. This is done by outputting the 
number of the key when the key is pressed. When the key is released the 
number is set again, but with bit 7 set. The result of this is that no key 
numbers greater than 127 are possible. You can find the assignment of the 
key numbers to the keys at the end of this section in figure 2. 1.2-1. In 
reality these numbers only go up to 1 17 because values from $F6 up are 
reserved for other purposes. There must be a way to pass more information 
than just key numbers to the main processor, information such as the clock 
time or the current position of the mouse. This cannot be handled in a single 
byte but only in something called a package, so the bytes at $F6 signal the 
start of a package. Which header comes before which package is explained 
along with the individual commands. 

A command to the keyboard processor consists of the command code (a 
byte) and any parameters required. The following description is sorted 
according to command bytes. 

$07 

Returns the result of pressing one of the two mouse buttons. A parameter 
byte with the following format is required: 
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Bit 0 =1 : 
Bit 1 =1 : 
Bit 2 =1 : 

Bits 3-7 


The absolute position is returned when a 
mouse button is pressed. Bit 2 must =0. 
The absolute position is returned when a 
mouse button is released. Bit 2 must =0. 
The mouse buttons are treated like 
normal keys. The left button is key 
number $74, the right is $75. 
must always be zero. 


$08 

Returns the relative mouse position from now on. This command tells the 
keyboard processor to automatically return the relative position (the distance 
from the previous position) whenever the mouse is moved. A movement is 
given when the number of encoder wheel pulses has reached a given 
threshold. See also $0B. A relative mouse package looks like this: 

1 byte Header in range $F8-$FB. The two lowest 

bits of the header indicate the condition 
of the two mouse buttons . 

1 byte Relative X-position (signed!) 

1 byte Relative Y-position (signed!) 

If the relative position changes substantially between two packages so that 
the distance can no longer be expressed in one byte, another package is 
automatically created which makes up for the remainder. 

$09 

Returns the absolute mouse position from now on. This command also sets 
the coordinate maximums. The internal coordinate pointers are at the same 
time set to zero. The following parameters are required: 

1 word Maximum X-coordinate 
1 word Maximum Y-coordinate 

Mouse movements under the zero point or over the maximums are not 
returned. 


$0A 

With this command it is possible to get the key numbers of the cursor keys 
instead of the coordinates. A mouse movement then appears to the operating 
system as if the corresponding cursor keys had been pressed. These 
parameters are necessary: 
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1 byte Number of pulses (X) after which the key 
number for cursor left (or right) will be 
sent . 

1 byte Number of pulses (Y) after which the key 

number for cursor up (or down) will be sent. 


$0B 

This command sets the trigger threshold, above which movements will be 
announced. A certain number of encoder pulses elapse before a package is 
sent. This functions only in the relative operating mode. The following are 
the parameters: 

1 byte Threshold in X-direction 

1 byte Threshold in Y-direction 

$oc 

Scale mouse. Here is determined how many encoder pulses will go by 
before the coordinate counter is changed by 1. This command is valid only 
in the absolute. The following parameters are required: 

1 byte X scaling 

1 byte Y scaling 

$ 01 ) 

Read absolute mouse position. No parameters are required, but a package of 
the following form is sent: 

1 byte Header = $F7 

1 byte Button status 

Bit 0=1: Right button was pressed since the 

last read 

Bit 1 = 1: Right button was not pressed 

Bit 2=1: Left button was pressed since the 

last read 

Bit 3 = 1: Left button was not pressed 

From this strange arrangement you can determine that the state of a button 
has changed since the last read if the two bits pertaining to it are zero. 

1 word Absolute X-coordinate 
1 word Absolute Y-coordinate 
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$0E 

Set the internal coordinate counter. The following parameters are required: 

1 byte =0 as fill byte 

1 word X-coordinate 

1 word Y-coordinate 

$0F 

Set the origin for the Y-axis is down (next to the user). 

$10 

Set the origin for the Y-axis is up. 

$11 

The data transfer to the main processor is permitted again (see $13). 

Any command other than $13 will also restart the transfer. 

$ 12 

Turn mouse off. Any mouse-mode command ($08, $09, $0A) turns the 
mouse back on. If the mouse is in mode $0A, this command has no effect. 

$13 

Stop data transfer to main processor. 

NOTE: Mouse movements and key presses will be stored as long as the 
small buffer of the 6301 allows. Actions beyond the capacity of the buffer 
will be lost. 

$14 

Every joystick movement is automatically returned. The packages sent have 
the following format: 

1 byte Header = $FE or $FF for joystick 0/1 

1 byte Bits 0-3 for the position (a bit for each 

direction) , bit 7 for the button 

$15 

End the automatic-return mode for the joystick. When needed, a package 
must be requested with $16. 

$16 

Read joystick. After this command the keyboard sends a package as 
described above. 
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$17 

Joystick duration message. One parameter is required. 

1 byte Time between two messages in 1/100 sec. 

From this point on, packages of the following form are sent continuously 
(as long as no other mode is selected): 

1 byte Bit 0 for the button on joystick 1 , bit 1 
for that of joystick 0 

1 byte Bits 0-3 for the position of joystick 1, 
bits 4-7 for the position of joystick 0 

NOTE: The read interval should not be shorter than the transfer channel 
needs to send the two bytes of the package. 

$18 

Fire button duration message. The condition of the button in joystick 1 (!) is 
continually tested and the result packed into a byte. This means that a 
message byte contains 8 such tests, whereby bit 7 is the most recent. The 
keyboard controller determines the time between byte fetches by the main 
processor. This time is divided into eight equal intervals in which the button 
is polled. The polling then takes place as regularly as possible. This mode 
remains active until another command is received. 

$19 

Cursor key simulation mode for joystick 0 (!). The current position of the 
joystick is sent to the main processor as if the corresponding cursor keys 
had been pressed (as often as necessary). To avoid having to explain the 
same things for the following parameters, here are the most important: All 
times are assumed to be in tenths of seconds. R indicates the time, when 
reached, cursor clicks will be sent in intervals of T. After this the interval is 
V. If R=0, only V is responsible for the interval. Naturally, this mechanism 
comes into play only when the joystick is held in the same position for 
longer than T or R. 


1 

byte 

RX 

1 

byte 

RY 

1 

byte 

TX 

1 

byte 

TY 

1 

byte 

VX 

1 

byte 

VY 
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$1A 

Turn off joysticks. Any other joystick command turns them on again. 

$1B 

Set clock time. This command sets the internal real-time clock in the 
keyboard processor. The values are passed in packed BCD, meaning a digit 
0-9 for each half byte, yielding a two-digit decimal number per byte. The 
following parameters are necessary: 

1 byte Year, two digit (85, 86, etc.) 

1 byte Month, two digit (12, 01, etc.) 

1 byte Day, two digit (31,01,02, etc.) 

1 byte Hours, two digit 

1 byte Minutes, two digit 

1 byte Seconds, two digit 

Any half byte which does not contain a valid BCD digit (such as F) is 
ignored. This makes it possible to change just part of the date or dock time. 

$1C 

Read clock time. After receiving this command the keyboard processor 
returns a package having the same format as the one described above. A 
header is added to the package, however, having the value $FC. 

$20 

Load memory. The internal memory of the keyboard processor (naturally 
only the RAM in the range $80 to $FF makes sense) can be written with this 
command. It is not clear to us of what use this is since according to our 
investigations (we have disassembled the operating system of the 6301), no 
RAM is available to be used as desired. Perhaps certain parameters can be 
changed in this manner which are not accessible through "legal" means. 
Here are the parameters: 

1 word Start address 

1 byte Number of bytes (max. 128) 

Data bytes (corresponding to the number) 

The interval at which the data bytes will be sent must be less than 20 msec. 
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$21 

Read memory. This command is the opposite of $20. These parameters are 
required: 

1 word Address at which to read 

A package having the following format is returned: 

1 byte Header 1 =$F6. This is the status header 

which precedes all packages containing any 
operating conditions of the keyboard 
processor. We will come to the general 
status messages shortly. 

1 byte Header 2 =$20 as indicator that this 
package carries the memory contents. 

6 bytes Memory contents starting with the address 
given in the command. 

Here is a small program which we used to read the ROM in the 6301 and 
output it to a printer. Here you also see how the status packages arrive from 
the keyboard. These are normally thrown away by the 68000 operating 
system. Section 3.1 contains information about the GEMDOS and XBIOS 
calls used. 


1 



prt 

equ 

0 

2 



chout 

equ 

3 

3 



gemdos 

equ 

1 

4 



bios 

equ 

13 

5 



xbios 

equ 

14 

6 



stvec 

equ 

12 

7 



rdm 

equ 

$21 

8 



wrkbd 

equ 

25 

9 



kbdvec 

equ 

34 

10 



term 

equ 

0 

11 



start : 



12 

00000000 

3F3C0022 


move . w 

f kbdvec, - <a7) 

13 

00000004 

4E4E 


trap 

#xbios 

14 

00000006 

548F 


addq . 1 

*2,a7 

15 

00000008 

4 1F900000000 


lea 

0, aO 

16 

OOOOOOOE 

43F9000000D6 


lea 

keyin, al 

17 

00000014 

23C000000104 


move . 1 

dO, savea 

18 

0000001A 

23F0000C00000100 


move . 1 

stvec (a0,d0) , save 

19 

00000022 

2189000C 


move . 1 

al, stvec {a0, dO) 
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20 

00000026 

383CF000 

move . w 

#$f000, d4 

21 



loop: 


22 

0000002A 

33C40000010A 

move.w 

d4, tbuf +1 

23 

00000030 

61000084 

bsr 

keyout 

24 



wait: 


25 

00000034 

QC390000000000F8 

cmpi .b 

#0, rbuf 

26 

0000003C 

67F6 

beq 

wait 

27 

0000003E 

3C3C0006 

move . w 

#6, d6 

28 

00000042 

610A 

bsr 

bufout 

29 

00000044 

5C44 

addq . w 

#6,d4 

30 

00000046 

0C44FFFF 

cmpi . w 

*$ffff,d4 

31 

0000004A 

6DDE 

bit 

loop 

32 

0000004C 

6052 

bra 

exit 

33 



bufout : 


34 

0000004E 

49F9000000F9 

lea 

rbuf + 1, a4 

35 



bytout : 


36 

00000054 

101C 

move . b 

<a4)+,d0 

37 

00000056 

6106 

bsr 

hexout 

38 

00000058 

5306 

subq.b 

#1, d6 

39 

0000005A 

66F8 

bne 

bytout 

40 

0000005C 

4E75 

rts 


41 



hexout : 


42 

0000005E 

3240 

move a . w 

dO, al 

43 

00000060 

E808 

Isr .b 

#4 , dO 

44 

00000062 

02800000000F 

andi.l 

*15, dO 

45 

00000068 

47F9000000E8 

lea 

table, a3 

46 

0000006E 

14330000 

move . b 

0 (a3,d0) ,d2 

47 

00000072 

E14A 

lsl.w 

#8,d2 

2} 

*3* 

00000074 

3009 

move.w 

al, dO 

49 

00000076 

02800000000F 

andi.l 

#15, dO 

50 

0000007C 

14330000 

move . b 

0 (a3, dO) , d2 

51 

00000080 

3002 

move . w 

d2,d0 

52 

00000082 

3F02 

move . w 

d2,-(a7) 

53 

00000084 

E048 

lsr .w 

#8, dO 

54 

00000086 

6108 

bsr 

chrout 

55 

00000088 

301F 

move.w 

(a7)+,d0 

56 

0000008A 

6104 

bsr 

chrout 

57 

0000008C 

103C0020 

move . b 

#" ", dO 

58 



chrout : 


59 

00000090 

3FOO 

move . w 

dO, - (a7) 

60 

00000092 

3F3COOOO 

move . w 

#prt,-(a7) 

61 

00000096 

3F3C0003 

move . w 

#chout, - (a7) 

62 

000 000 9A 

4E4D 

trap 

#bios 

63 

0000009C 

5C8F 

addq . 1 

#6,a7 

64 

0000009E 

4E75 

rts 


65 



exit: 


66 

OOOOOOAO 

307900000104 

move a 

savea, aO 
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6? 

OOOQOOA6 

203900000100 


move . 1 

save.dO 

68 

OOOOOOAC 

2140000C 


move . 1 

d0, stvec (a 0 ) 

69 

OOOOOOBO 

3F3COOOO 


move . w 

#term, - (a7> 

70 

OOOOOOB4 

4E4 1 


trap 

fgemdos 

71 



keyout : 



72 

OOOOOOB6 

1 3FC000 0 00000 0F8 


move . b 

#0, rbuf 

73 

OOOOOOBE 

487900000109 


pea 

tbuf 

74 

OOOOOOC4 

3F3C0002 


move . w 

#2, - (a7) 

75 

OOOOOOC8 

3F3C0019 


move.w 

#wrkbd, - (a7) 

76 

OOOOOOCC 

4 E4E 


trap 

#xbios 

77 

OOOOOOCE 

DFFC00000008 


adda . 1 

#8,a7 

78 

OOOOOOD4 

4E75 


rts 


79 



keyin: 



80 

OOOOOOD6 

103C0008 


move . b 

#8, dO 

81 

OOOOOODA 

43F9000000F8 


lea 

rbuf, al 

82 



repin : 



83 

OOOOOOEO 

12D8 


move . b 

<a0)+, (al ) + 

84 

OOOOOOE2 

5300 


subq . b 

41, dO 

85 

OOOOOOE4 

66FA 


bne 

repin 

86 

OOOOOOE6 

4E75 


rts 


87 



table: 



88 

OOOOOOE8 

3031323334353637 


dc.b 

"0123456789ABCDEF" 

88 

OOOOOOEO 

3839414243444546 




89 

OOOOOOF8 


rbuf : 

ds.b 

8 

90 

00000100 


save 

ds.l 

1 

91 

00000104 


savea 

ds.l 

1 

92 

00000108 


dummy 

ds.b 

1 

93 

00000109 

21 

tbuf 

dc.b 

rdm 

94 

0000010A 



ds.b 

2 

95 

0000010C 



.end 
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$22 

Execute routine. With this command you can execute a subroutine in the 
6301. Naturally, you must know exactly what it does and where it is 
located, so long as you have not transferred it yourself to RAM with $20 
(assuming you found some free space). The only required parameters are: 

1 word Start address 

Status messages 

You can at any time read the operating parameters of the keyboard by 
simply adding $80 to the command byte with which you would to set the 
operating mode (whose parameters you want to know). You then get a 
status package back (header=$F6), whose format corresponds exactly to 
those which would be necessary for setting the operating mode. 

An example makes it clearer: you want to know how the mouse is scaled. 
So you send as the command the value $8C (since $0C sets the scaling). 
You get the following back: 

1 byte Status header =$F6 
1 byte X-scaling 
1 byte Y-scaling 

This is the same format which would be necessary for the command $0C. 
For commands which do not require parameters, you get the evoked 
command back as such. For example, say you want to know what operating 
mode the joystick is in ($14 or $15). You send the value $94 (or $95, it 
makes no difference). As status package you receive, in addition to the 
header, either $14 or $15 depending on the operating mode of the joystick 
handler. 

Allowed status checks are: $87, $88, $89, $8A, $8B, $8C, $8F, $90, $92, 
$94, $99, and $9A. 

In conclusion we have a tip for those for whom the functions of the 
keyboard are too meager and who want to give it more "intelligence”. The 
processor 6301 is also available in "piggy-back" version, the 63P01 
(Hitachi). This model does not have ROM built in, but has a socket on the 
top for an EPROM of type 2732 or 2764 (8K!). You can then realize your 
own ideas and, for example, use the two joystick connections as universal 
4-bit I/O ports, for which you can also extend the command set in order to 
access the new functions from the XBIOS as well. 
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Figure 2.1.2-1 ATARI ST Key Assignments 
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2.2 The Video Connection 


Without this, nothing would be displayed. You would be tapping in the 
dark in the truest sense of the word. Conspicuous are the many pins on the 
connection. Naturally more lines are required for hooking up an RGB 
monitor than for a monochrome screen, but seven would be enough. There 
is also something special about the remaining lines. In Figure 2.2-1 you 
find a block diagram in which you can see how the video connection is tied 
to the system. The numbering of the pins is given on the figure on the next 
page, as you can see, when you look at the connector from the outside. 
Here is the pin layout: 

1 AUDIO OUT. This connection comes from the amplifier 
connected to the output of the sound chip. A high-impedance 
earphone can be attached here if you do not use the original 
monitor. 

2 Not used 

3 GPO, General Purpose Output. This connection is available for 
your use. The line has TTL levels and comes from I/O port A bit 6 
of the sound chip. 

4 MONOCHROME DETECT. If this line, which leads to the 17 
input of the MFP 68901, is low, the computer enters the 
high-resolution monochrome mode. If the state of the line changes 
during operation, a cold start is generated. 

5 AUDIO IN leads to the input of the amplifier described in 1 and is 
there mixed with the output of the sound chip. 

6 GREEN is the analog green output of the video shifter. 

7 RED. Red output. 

8 GROUND. 

9 HORIZONTAL SYNC is responsible for the horizontal beam 
return of the monitor. 
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Figure 2.2-1 Diagram of Video Interface 
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10 BLUE is the analog blue output of the video shifter. 

1 1 MONOCHROME provides a monochrome monitor with the 
intensity signal. 

12 VERTICAL SYNC takes care of the beam return at the end of the 
screen. 

13 GROUND. 

A tip for the hardware hobbyist: 

A plug to fit this connector is not available. If you want to make a plug for 
connecting other monitors, simply use a piece of perf board in which you 
have soldered pins, since the pins are fortunately organized in a 1/10" array. 
Pin 13 is out of order, but it is not needed since pin 8 is also available for 
ground. 


Figure 2.2-2 Monitor Connector 
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2.3 The Centronics Interface 


A standard Centronics parallel printer can be connected to this interface, 
provided that you have the proper cable. As you can see in Figure 2.3-2, the 
connection to the system is somewhat unusual. The data lines and the strobe 
of the universal port of the sound chip are used. So you find these too on 
the picture, in which the other lines, which will not be described in the 
section, will not disturb you. They belong to the disk drive and RS-232 
interface and are handled there. 

Here is the pin description: 

I -STROBE indicates the validity of the byte on the data lines 
to the connected device by a low pulse. 

2-9 DATA 

I I BUSY is always placed high by the printer when it is not 
able to receive additional data. This can have various causes. 
Usually the buffer is full or the device is off line. 

18-15 GROUND. 

All other pins are unused. 

A tip for making a cable. Get flat-cable solderless connectors. You need a 
type D25-subminiature, a Cinch 36-pin (3M,AMP) and the appropriate 
length of 25-conductor flat ribbon cable. You squeeze the connectors on the 
cable so that pins 1 match up on both sides (they are connected together). 
The other connections then match automatically. Note that there will 
naturally be some pins free on the printer side. 


Figure 2.3-1 Printer Port Pins 
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I 

2.4 The RS-232 Interface 


This interface usually serves for communication with other computers and 
modems. You can also connect a printer here. Note the description of pin 5! 

Figure 2.4-1 shows the connection to the system. Normally you don’t have 
to do any special programming to use this interface. It is taken care of by the 
operating system. Here the control of the interface is not controlled by a 
special IC (UART) as is usually the case, but the lines are serviced more or 
less "by hand." The shift register in the MFP is used for this purpose. The 
handshake lines however come from a wide variety of sources. Note this in 
the following pin description: 

1 CHASSIS GROUND (shield) 

This is seldom used. 

2 TxD 
Send data 

3 RxD 
Receive data 

4 RTS 

Ready to send comes from I/O port A bit 3 of the sound 
chip and is always high when the computer is ready to 
receive a byte. On the Atari, this signal is first placed low 
after receiving a byte and is kept low until the byte has 
been processed. 

5 CTS 

Clear to send of a connected device is read at interrupt 
input 12 of the MFP. At the present time this signal is 
handled improperly by the operating system. Therefore it 
is possible to connect only devices which "rattle” the line 
after every received byte (like the 520ST with RTS). The 
signal goes to input 12 of the MFP, but unfortunately is 
tested only for the signal edge. You will not have any luck 
connecting a printer because they usually hold the CTS 
signal high as long as the buffer is not full. There is no 
signal edge after each byte, which means that only the 
first byte of a text is transmitted, and then nothing. 
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7 GND 
Signal ground. 

8 DCD 

Carrier signal detected. This line, which goes to interrupt 
input II of the MFP, is normally serviced by a modem, 
which tells the computer that connection has been made 
with the other party. 

20 DTR 

Device ready. This line signals to a device that the 
computer is turned on and the interface will be serviced as 
required. It comes from I/O port A bit 4 of the sound 
chip. 

22 RI 

Ring indicator is a rather important interrupt on 16 of the 
MFP and is used by a modem to tell the computer that 
another party wishes connection, that is, someone called. 
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2.5 The MIDI Connections 


The term MIDI is probably unknown to many of you. It is an abbreviation 
and stands for Musical Instrument Digital Interface, an interface for musical 
instruments. 

It is certainly clear that we can't simply hook up a flute to this port. So first 
a little history. Music professionals (more precisely: keyboardists, 
musicians who play the synthesizer) demanded agreement between the 
various manufacturers to interface computers to musical instruments. They 
found it absurd to connect complicated set-ups with masses of wire. The 
idea was to service several synthesizers from one keyboard. 

The tone created was basically analog (and still is, to a degree), so that the 
manafacturers agreed that a control voltage difference of IV corresponded to 
a difference in tone of 1 octave. This way one could play several devices 
under "remote control," but not service them. 

This changed substantially when the change was made to digital tone 
creation. Here one didn't have to turn a bunch of knobs, there were buttons 
to press, whereby the basis for digital control was created. 

Some manufacturers got together and designed a digital interface, the basic 
commands of which would be the same throughout, but which would still 
support the additional features of a given device. 

The device is based on the teletype, the current-loop principle, which is not 
very susceptible to noise, but significantly faster. The transfer rate is 31250 
baud (bits per second). The data format is set at one start bit, eight data bits, 
and one stop bit 

An IC can therefore be used for control which would otherwise be used for 
RS-232 purposes. You see the connection to the system in figure 2.5-1. 

Logically, MIDI is multi-channel system, meaning that 16 devices can be 
serviced by one master, or a device with 16 voices. These devices are all 
connected to the same line (bus principle). To identify which device or 
which voice is intended, each data packet is preceded by the channel 
number. The device which recognizes this number as its own then executes 
the desired action. 
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You may wonder what such an interface is doing in a computer. A computer 
can provide an entire arsenal of synthesizers with settings or complete 
melodies (sequencer) because of its high speed and memory capacity. It can 
also be used to record and store input from a synthesizer keyboard. 

For tills purpose the ST has the interfaces MIDI-IN and MIDI-OUT. The 
interfaces are even supported by the XBIOS so you don't have to worry 
about their actual operation. 

The current loop travels on pins 4 and 5, out through pin 4 (+) of 
MIDI-OUT and in at 5, when a device is connected 

For MTDT-TN the situation is reversed because the current flows in through 
pin 4 and back out through pin 5. It goes though something called an 
optocoupler which electrically isolates the computer from the sender. 

The receive data are looped back to MIDI-OUT (pins 1 and 3), which 
implements the MIDI-THRU function, although not entirely according to 
the standard. 
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2.6 The Cartridge Slot 


The cartridge slot can be used exclusively for inserting ROM cartridges. Up 
to 128K in the address space $FAOOOO to SFBFFFF can be addressed. The 
reason we stressed the exclusivity of the read access is the following. We 
thought it would be practical to outfit a cartridge with RAM and then load 
programs into it after the system start which would still remain after a reset 
In order to try this we brought the R/-W signal to the outside. The 
experience taught us, however, that a write access to these addresses creates 
a bus error. The GLUE takes care of this. As you see, nothing is left to 
chance in the Atari. 


Figure 2.6-1 The Cartridge Slot 
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D6 
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D7 
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D4 
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D5 
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D2 
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DO 
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D1 
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A 1 3 
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1 

21 


20 

40 
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2.7 The Floppy Disk Interface 


The interface for floppy disk drives is conspicuous because of the unusual 
connector, a 14-pin DIN connector. All of the signals required for the 
operation of two disk drives are available on it. 

You know most of the signals from the description of the disk controller 
1772, since nine of the available connections are directly or via a buffer 
connected to the controller. Only the drive select 1 and drive select 2 signals 
and the side 0 select are not derived from the disk controller. These signals 
come from port A of the sound chip. 

Pinout of the disk connector: 

1 READ DATA 

2 SIDE 0 SELECT 

3 GND 

4 INDEX 

5 DRIVE 0 SELECT 

6 DRIVE 1 SELECT 

7 GND 


8 MOTOR ON 

9 DIRECTION IN 

10 STEP 

11 WRITE DATA 

12 WRITE GATE 

13 TRACK 00 

14 WRITE PROTECT 
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2.8 The DMA Interface 


Up to 8 external devices can be connected to this 19-pin subminiature D 
connector. Such devices include hard disks, networks, and also 
coprocessors. The communication between the external devices and the ST 
runs at speeds up to 1 million bytes per second. Unfortunately, no 
experiments with DMA devices could be performed at the time this was 
printed. For this reason we cannot make the following statements with one 
hundred percent certainty. 

The RESET line on pin 12 permits devices to be reset by the Atari. If this 
pin is low, as is the case when the Atari is turned on or when executing a 
RESET command, external devices are placed in a defined power-up state, 
without having to individually turn each device off and then on again. 

Since most of the external devices will use a controller IC, the signal CS, 
Chip Select on pin 9, must also be available. The signal A1 is also to be 
seen in connection with this, because it is then important if the controller has 
more than just one register. This signal can distinguish between two 
registers. 

The data transfer takes place over the bidirectional data bus on pins 1 to 8. 
The R/W line on the DMA bus determines the direction of the data transfer. 
The DMA chip can either write data to the bus (R/W is high), or read data 
from the bus (R/W is low). Data can be read or written only on the request 
of the external device. The release of a transfer is signaled by the signal 
DRQ (pin 19). 

The ACK signal on pin 14 appears to be a purely hardware-dependent 
confirmation of the DRQ signal. The actual significance could not be 
checked however. 

The last signal on the DMA port is the 1NT input. A low on this connection 
can generate an interrupt The hard disk, for example, signals the end of the 
command through a low. The interrupt uses the same interrupt input on the 
MFP as the disk controller. This is input I/O 5. This means the at the floppy 
disk drive and the hard disk cannot transfer data together. The DMA is also 
not in such a position since it has only one DMA channel available. 

The interrupt of this input is disabled in the MFP internally because the 
floppy as well as the hard disk routines check the port bit in a loop in order 
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to determine the end of the command. This simplifies the implementation of 
the time out, which is always generated when the floppy or hard disk has 
not reacted to the command within a certain length of time. 




Figure 2.8-1 DMA Port 

i inumt7 


19 


11 


Figure 2.8-2 DMA Connections 
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The ST Operating System 


GEMDOS-what is it? Is it in the ST? The operating system is supposed to 
be TOS, though. Or CP/M 68K? Or what? 

This question can be answered with few words. The operating system in the 
ST is named TOS-Tramiel Operating System-after the head of Atari. This 
TOS, in contrast to earlier information has nothing to do with CP/M 68K 
from Digital Research. At the start of development of the ST, CP/M 68K 
was implemented on it, but this was later changed because CP/M 68K is not 
exactly a model of speed and efficiency. A 68000 running at 8MHz and 
provided with DMA would be slowed considerably by the operating 
system. 

At the beginning of 1985, Digital Research began developing a new 
operating system for 68000 computers, which would include a user-level 
interface. This operating system was named GEMDOS. It is exactly this 
GEMDOS which makes up the hardware-independent part of TOS. Like 
CP/M, TOS consists of a hardware-dependent and a hardware-independent 
part. The hardware-dependent part is the BIOS and the XBIOS, while the 
hardware-independent part is called GEMDOS. A large number of functions 
are built into GEMDOS, through which the programmer can control the 
actual input/output functions of the computer. Functions for keyboard input, 
text output on the screen or printer, and the operation of the various other 
interfaces are all present. Another quite important group contains the 
functions for file handling and for logical file and disk management 
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3.1 The GEMDOS 


When you look at the functions available under GEMDOS, you will 
eventually come to the conclusion that the whole thing is not really new. All 
the functions in GEMDOS are very similar to the functions of the MS-DOS 
operating system. Even the functions numbers used correspond to those of 
MS-DOS. But not all MS-DOS functions are implemented in GEMDOS. 
Especially in the area of file management, only the UNIX compatible 
functions are implemented in GEMDOS. The "old” block-oriented 
functions which are included in MS-DOS to maintain compatibility with 
CP/M are missing from GEMDOS. Also, special functions relating to the 
hardware of MS-DOS computers (8088 processor) are missing. 

Another essential difference between MS-DOS and GEMDOS is that for 
GEMDOS calls as well as for the BIOS and XBIOS, the function number, 
the number of the desired GEMDOS routine, and the required parameters 
are placed on the stack and are not passed in the registers. The 68000 is 
particularly suited to this type of parameters passing. GEMDOS is called 
with TRAP # 1 and the function is executed according to the contents of 
the parameter list After the call, the programmer must put the stack back in 
order himself, by clearing the parameters from memory. 

The basic call of GEMDOS functions differs from the BIOS and XBIOS 
calls only in the trap number. 

In regard to all GEMDOS calls, it must be noted that registers DO and AO 
are changed in all cases. If a value is returned, it is returned in DO, or DO 
may contain an error number, and after the call AO (usually) points to the 
stack address of the function number. Any parameters required in DO or AO 
must be placed there before GEMDOS is called. 

The remainder of this section describes the individual GEMDOS functions. 


104 


Abacus Software 


Atari ST Internals 


$00 TERM 

Calling GEMDOS with function number 0 ends the running program and 
returns to the program from which it was started. For applications, 
programs started from the desktop, program control is returned to the 
desktop. If the program was called from a different program, execution is 
passed back to the calling program. This point is important for chaining 
program segments. 


CLR.W -(SP) 
TRAP 


$01 CONIN 

CONIN fetches a single character from the keyboard. The routine waits 
until a character is available. The result, the character read from the 
keyboard, is returned in the DO register. The ASCII code of the pressed key 
is returned in the low byte of the low word, while the low byte of the high 
word of the register contains the scan code returned from the keyboard. 
This is important when reading keys which have no ASCII code. This 
applies to the 10 function keys or the keys of the cursor block, for example. 
These keys return the ASCII value zero when pressed. 

If needed, the scan code can be used to determine if the digits on the keypad 
or the main keyboard were pressed, since these keys have identical ASCII 
codes, but return different scan codes. 


MOVE . W #l f -(SP) 
TRAP #1 
ADDQ.L #2, SP 


* Function number on the stack 

* Call GEMDOS 

* Correct stack 
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$02 CONOUT 

CONOUT represents the simplest and most primitive character output of 
GEMDOS. With this function only one character is printed on the screen. 
The character to be displayed is placed on the stack as the first word. The 
ASCH value of the character to be printed must be in the low byte of the 
word and the high byte should be zero. 

The character printed by CONOUT is outputted to device number 2, the 
normal console output. Control characters and escape sequences are 
interpreted normally. 


MOVE . W #*A’,-(SP) 
MOVE . W #2,-(SP) 
TRAP #1 
ADDQ.L #4,SP 


* Output an A 

* CONOUT 

* Call GEMDOS 

* Correct stack 


$03 AUXILLIARY INPUT 

Under the designation "auxilliary port*' is the RS-232 interface of the ST. 
A character can be read from the interface with the function CAUXIN. The 
function returns when a character has been completely received. The 
character is returned in the lower eight bits of register DO. 


$04 AUXILLIARY OUTPUT 

Similar to the input of characters via the serial interface, a character can be 
sent with this function. With this function the programmer should clear the 
upper eight bits of the word and pass the character to be sent in the lower 
eight bits. 
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$05 PRINTER OUTPUT 

PRINTER OUTPUT is the simplest method of operating a printer connected 
to the Centronics interface. One character is printed with each call. 

An important part of PRINTER OUTPUT is th e return valu e in DO. If the 
character was sent to the printer, the value -1 ($FFFFFFFF) is returned in 
DO. If, after 30 seconds, the printer was unable to accept the character (not 
turned on, OFF LINE, no paper, etc.), GEMDOS returns a time out to the 
program. DO then contains a zero. 


MOVE .M # * A* , — (SP) 
MOVE -W #5/ - (SP) 

TRAP #1 
ADDQ.L #4,SP 
TST.W DO 

BEQ printererror 


* Output an A 

* Function number 

* Call GEMDOS, output character 

* Correct stack 

* Affect flags 


$06 RAWCONIO 

RAWCONIO is a somewhat unusual mixture of keyboard input and screen 
output and receives a parameter on the stack. 

With a function value of $FF the keyboard is tested. If a character is 
present, the ASCII code and scan code are passed in DO as described for 
CON1N. But if no key value is present, the value zero is passed as both the 
ASCII code and the scan code in DO. The call to RAWCONIO with 
parameter $FF is comparable to the BASIC INKEY$ function. 

If a value other than $FF is passed to the function, the value is interpreted as 
a character to be printed and it is output at the current cursor position. This 
output also interprets the control characters and escape sequences properly. 
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START: 


MOVE . W 

#$FF,-(SP) 

* 

Function value test keyboard 

MOVE.W 

#6,-{SP) 

* 

Function number 

TRAP 

#1 

* 

Call GEMDOS, test keyboard 

ADDQ.L 

#4,SP 

* 

Correct stack 

TST.W 

DO 

* 

Character arrived? 

BEQ 

START 

* 

Not yet 

CMP.B 

#3, DO 

* 

A C selected as the end marker 

BEQ 

END 



MOVE 

DO, — (SP) 

* 

Character for output on the stack 

MOVE 

#6, — (SP) 

* 

Function number 

TRAP 

#1 

* 

Call GEMDOS, test keyboard 

ADDQ.L 

#4, SP 

* 

Correct stack 

BRA 

START 

* 

Get new character 


$07 DIRECT CONIN WITHOUT ECHO 

The function $07 differs from $01 only in that the character received from 
the keyboard is not displayed on the screen. It waits for a key just as does 
CONIN. 


$08 CONIN WITHOUT ECHO 

Function $08 does not differ from function $07. Both function calls have 
exactly the same effect The reason for this seemingly nonsensical behavior 
lies in the mentioned compatibility to MS-DOS. Under MS-DOS the two 
functions are different in that with $08, certain keys not present on the 
ATARI are evaluated correctly, while this evaluation does not take place 
with function $07. 
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$09 PRINT LINE 

You have already become familiar with functions to output individual 
characters on the screen with CONOUT and RAWCONIO. PRINT LINE 
offers you an easy way to output text. An entire string can be printed at the 
current cursor position with this function. To do this, the address of the 
string is placed on the stack as a parameter. The string itself is concluded 
with a zero byte. Escape sequences and control characters can also be 
evaluated with this function. 

After the call, DO contains the number of characters which were printed. 
The length of the string is not limited. 


MOVE . L 

#text,-(SP) 

* 

Address of the string on the stack 

MOVE 

#$09, -(SP) 

* 

Function number PRT LINE 

TRAP 

#1 

* 

Call GEMDOS 

ADDQ.L 

• 

#6, SP 

* 

"Clean up" the stack 

• 

text 

.DC .B ‘This 

is 

the string to be printed' , $0D, $0A, 0 


$0A READLINE 

READLINE is a very easy-to-use function for reading characters from the 
keyboard. In contrast to the ’’simpler" character-oriented input functions, an 
entire input line can be fetched from the keyboard with READLINE. The 
characters entered are displayed on the screen at the same time. 

The address of an input buffer is passed to the function as the parameter. 
The value of the first byte of the input buffer determines the maximum 
length of the input line and must be initialized before the call. At the end of 
the routine, the second byte of the buffer contains the number of characters 
entered. The characters themselves start with the third byte. 

The routine used by READLINE for keyboard input is quite different from 
the character-oriented console inputs. Escape sequences are not interpreted 
during the output. Only control characters like control-H (backspace) and 
control-I (TAB) are recognized and handled appropriately. The following 
control characters are possible: 
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A C Ends input AND program ( > ) 

A H Backspace one position 
A I TAB 

A J Linefeed, end input 
A M CR, end input 

A R Entered line is printed in new line 
A U Don't count line, start new line 
A X Clear line, cursor at start of line 


A function like A H, deleting a character entered, is useful, but for large 
programs you should write your own input routine because A C is very 
"dangerous." Unlike CP/M, the program will be ended even if the cursor is 
not at the very start of the input line. 

If more characters are entered than were indicated in the first byte of the 
buffer at the initialization, the input is automatically terminated. If the input 
is terminated by ENTER, A J, or A M, the terminating character will not be 
put in the buffer. 

After the input, DO contains the number of characters entered, excluding 
ENTER, which can be found at buffer+1 . 


$0B CONSTAT 

All key presses are first stored in a buffer in the operating system. This 
buffer is 64 bytes in length. The key values stored there are taken from the 
buffer when a call to a GEMDOS output routine is made. 

CONSTAT can be used to check if characters are stored in the keyboard 
buffer. After the call, DO contains the value zero or $FFFF. A zero in DO 
indicates that no characters are available. 


$0E SETDRV 

The current drive can be determined with the function SETDRV. A 16-bit 
parameter containing the drive specification is pased to the routine. Drive A 
is addressed with the number 0 and drive B with the number 1. 

After the call, DO contains the number of the drive active before the call. 
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$10 CONOUT STAT 

CONOUT STAT returns the status of the console in DO. If the value $FFFF 
is returned, a character can be displayed on the screen. If die returned value 
is zero, however, no character output is possible on the screen at that time. 
Incidently, all attempts to create a not-ready status at the console failed. The 
only imaginable possibility for the not-ready status would be if the output of 
the individual bit pattern of a character was interrupted and the interrupt 
routine itself tried to output a character. This case could not, however, be 
created. 


$11 PRTOUT STAT 

This function returns the status, the condition of the Centronics interface. If 
no printer is connected (or turned off, or off line), DO contains the value 
zero after the call to indicate "printer not available." If, however, the printer 
is ready to receive, DO contains the value $FFFF. 


$12 AUXIN STAT 

By calling AUXIN STAT you can determine if a character is available from 
the receiver of the serial interface ($FFFF) or not ($0000). As with all other 
functions, the value is returned in DO. 


$13 AUXOUT STAT 

AUXOUT STAT gives information about the state of the serial bus. A value 
of $FFFF indicates that the serial interface can send a character, while zero 
indicates that no characters can be sent at this time. 


$19 CURRENT DISK 

For many applications it is necessary to know which drive is currently 
active. The current drive can be determined by the function $19. After the 
call, DO contains the number of the drive. The significance of the drive 
numbers is the same as for $GE, SET DRIVE (0-A, 1=B). 
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$1A SET DISK TRANSFER ADDRESS 

The disk transfer address is the address of a 44-byte buffer required for 
various disk operations (especially directory operations). Along with the 
GEMDOS functions SEARCH FIRST and SEARCH NEXT are examples 
for using the DTA. 


MOVE .L #DTADDRESS, — (SP) 
MOVE . W #$1A,-(SP) 

TRAP #1 
ADDQ.L #6, SP 


* Address of the 44-byte DTA buffer 

* Function number SET DTA 

* Set DTA 

* Clean up the stack 


$20 SUPER 

This function is especially interesting for programmers who want to access 
the peripheral components or system variables available only in the 
supervisor mode while running a program in the user mode. After calling 
this function from the user mode, the 68000 is placed in the supervisor 
mode. In contrast to the XBIOS routine for enabling the supervisor mode, 
additional GEMDOS, BIOS, and XBIOS calls can be made after a 
successful SUPER call. 

First we will look at the case in which the SUPER function is called from a 
program in the user mode with a value of zero on the stack. In this case the 
program finds itself in the supervisor mode after the call. The supervisor 
stack pointer is set to the value of the user stack pointer and the original 
value of the supervisor stack pointer is returned in DO. This value should be 
stored by the program in order to get back into the user mode later. 

If a value other than zero is passed to the SUPER function the first time it is 
called, this value is interpreted as the desired value of the supervisor stack 
pointer. In this case as well, DO contains the original value of the supervisor 
stack pointer, which the program should save. 

Before a program ends, the user mode should be reenabled. This change of 
operating modes requires the address acquired the first time the routine was 
called in order to set the supervisor stack pointer back to its original value. 
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The SUPER function differs from all other GEMDOS functions in one very 
important respect Under certain circumstances, this call can also change the 
contents of A1 and Dl. If you store important values in these registers, you 
must save the values somewhere before calling the SUPER function. 


CLR.L -(SP) 

MOVE . W #$20, — (SP) 
TRAP #1 

ADD.L $6, SP 

MOVE . L DO, _SAVE_SSP 


* The 6800 i3 in the user mode 

* User stack becomes supervisor stack 

* Call SUPER 

* The supervisor mode is active 

* after the TRAP 

* DO = old supervisor stack 

* Save value 


Here processing can be done in the supervisor mode 


MOVE . L _SAVE_SSP,-(SP) * Old supervisor stack pointer 
MOVE . W #$20,- (SP) * Call SUPER 

TRAP #1 * Now we are back in the user mode 

ADD.L #6, SP 


$2A GET DATE 

You have no doubt experimented with the status field at one time or another. 
In addition to various other functions, the status field contains a clock with 
clock time and date. It can be useful for some applications to have the data 
available. The date can be easily determined by the GET DATE function. 
This function call requires no parameters and makes the date available in the 
low word of register DO. It is rather thoroughly encoded, though, so that 
the result in DO must be prepared in order to get the correct date. 

The day in the range 1 to 31 is coded in the lower five bits. Bits 5 to 8 
contain the month in the value range 1 to 12, and the year is contained in 
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bits 9 to 15. The value range in these "year bits” goes from 0 to 1 19. The 
value of these bits must be added to the value 1980 in order to get the actual 
year. The date 12/12/1992, for example, would result in $198C in DO. This 
can be represented in binary as %0001 100.1 100.01 100. The lengths of the 
three fields are marked with periods. 


$2B SET DATE 

The clock time and date can also be set from application programs. This is 
particularly interesting for programs which use the date and/or clock time. 
An example of this would be invoice processing in which the current date is 
inserted in the invoice. Such programs can then ask the user to enter the 
date. This avoids the problems that occur if the user forgets to set the date 
and clock time on the status field beforehand. 

The date must be passed to the function SET DATE in the same format as it 
is received from GET DATE, bits 0-4 = day, bits 5-8 = month, bits 9-15 = 
year- 1980. 


MOVE . W #%101101011001,-(SP) 
MOVE . W #$2B,-<SP) 

TRAP #1 
ADDQ.L #6, SP 


* Set date to 10/25/1985 

* Function number of SET DATE 

* Set date 

* Repair stack 


$2C GET TIME 

The function GET TIME returns the current (read: set) time from the 
GEMDOS clock. Similar to the date, the clock time is coded in a special 
pattern in individual bits of the register DO after the call. The seconds are 
represented in bits 0-4. But since only values from 0 to 31 can be 
represented in 5 bits, the internal clock runs in two second increments. In 
order to get the correct seconds-result the contents of these five bits must be 
multiplied by two. The number of minutes is contained in bits 5 to 10, while 
the remaining bits 11-15 give information about the hour (in 24-hour 
format). 
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$2D SET TIME 

It is also possible to set the clock time under GEMDOS. The function SET 
TIME expects a 16- bit value (word) on the stack, in which the time is coded 
in the same form as that in which GET TIME returns the clock time. 


MOVE . W #%1000101010U1101,-(SP> 
MOVE . W #$2D,-(SP) 

TRAP #1 
ADDQ.L #6,SP 


* Clock time 17:21:58 

* Function # of GET TIME 

* Set date 

* Repair stack 


$2F GET DTA 

The function $2F is the counterpart of function $1 A, SET DTA. A call to 
this function returns the address of the current disk transfer buffer in DO. 
An exact explanation of this buffer is found together with the functions 
SEARCH FIRST and SEARCH NEXT. 


$30 GET VERSION NUMBER 

Calling this function returns in DO the version number of GEMDOS. In the 
version of GEMDOS currently in release, this question is always answered 
with $0D00, corresponding to version 13.00. Official Atari documentation 
claims that a value of $0100 should be returned for this version, though 
perhaps the value should indicate that the present GEMDOS version is the 
$D = diskette version. 


$31 KEEP PROCESS 

This function is comparable to the GEMDOS function TERM $00. The 
program is also ended after a call to this function. $31 does differ from $00 
in several important points. 

After processing TRAP #1, like TERM, control is passed back to the 
program which started the program just ended. In contrast to TERM, a 
termination condition can be communicated to the caller. While TERM 
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returns the termination value zero (no error), zero or one may be selected as 
the termination value for $31. A value other than zero means that an error 
occurred during program processing. 

Another essential point lies in the memory management of GEMDOS. When 
a program is started, the entire available memory space is made available to 
it. If the program is ended with TERM, the memory space is released and 
made available to GEMDOS. The entire area of memory released is also 
cleared, filled with zeros. The program actually physically disappears from 
the memory. With function $31, however, an area of memory can be 
protected at the start address of the program. This memory area is not 
released when the program is ended and it is also not cleared. The program 
could be restarted without having to load it in again. 

KEPP PROCESS is called with two parameters. The example programs 
shows the parameter passing. 


MOVE . W #0,-<SP) 

MOVE . L #$1000, -(SP) 
MOVE . W #$31,- (SP) 
TRAP #1 


* Error code no error, else 1 

* Protect $1000 bytes at program start 

* Function number, end program 

* now 


$36 GET DISK FREE SPACE 

It can be very important for disk-oriented programs to determine the amount 
of free space on the diskette. Then you have the ability to request that the 
user change disks at the appropriate time. "Disk full" messages or even data 
loss can then be avoided. 

Function $36 returns exactly this information. The number of the desired 
disk drive and the address of a 16-byte buffer must be passed to the 
function. If the value 0 is passed as the drive number, the information is 
fetched from the active drive, a 1 takes the information from drive A, and a 
2 from drive B. 

The information passed in the buffer is divided into four long words. The 
first long word contains the number of free allocation units. Each file, even 
if it is only eight bytes long, requires at least one such allocation unit 
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The second long word gives information about the number of allocation 
units present on the disk, regardless of whether they are already used or are 
still free. For the "small ” single-sided diskettes this value is $15C or 351, 
while the double-sided disks have $2C7 = 711 allocation units. The third 
long word contains the size of a disk sector in bytes. For the Atari this is 
always 512 bytes ($200 bytes). 

In the last word is the number physical sectors belonging to an allocation 
unit. This is normally 2. Two sectors form one allocation unit 

The number of available bytes of disk space can easily be calculated from 
this information. 


MOVE . W 

#0,-<SP) 

* 

Information from the active drive 

MOVE . L 

#BUFFER,-(SP) 

* 

Address of the 16-byte buffer 

MOVE 

#$36, -(SP) 

* 

Function number 

TRAP 

#1 



ADDQ.L 

#8, SP 

* 

Clean up stack 

.bss 




BUFFER: 




f real: 

. ds . 1 1 

* 

Free allocation units 

total: 

.ds.l 1 

* 

Total allocation units 

bps : 

.ds .1 1 

* 

Bytes /physical sector 

pspal: 

.ds.l 1 

* 

Phys. sectors/alloc, unit 


$39 MKDIR 

A subdirectory can be created from the desktop with the menu option "NEW 
FOLDER". Such a subdirectory can also be created from an application 
program with a call to $39. 

In order to create a new folder, the function $39 is given the address of the 
folder name, also called the pathname. This name may consist of 8 
characters and a three-character extension. The same limitations apply to 
pathnames as do to filenames. The pathname must be terminated with a zero 
byte when calling MKDIR. 
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After the call, DO indicates whether the operation was performed 
successfully. If DO contains a zero, the call was successful. Errors are 
indicated through a negative number in DO. At the end of this chapter you 
will find an overview of all of the error messages occurring on connection 
with GEMDOS functions. 


MOVE . L #pathname * Address of the pathname 

MOVE #$39, -(SP) * Function number 

TRAP #1 

ADDQ.L #6, SP * Repair stack 

TST.W DO * Error occurred? 

BNE error * Apparently 


pathname : 

.dc.b • private.dat • ,0 


$3A RMDIR 

A subdirectory created with MKDIR can be removed again with $3 A. As 
before, the pathname, terminated with a zero, is passed to RMDIR. The 
error messages also correspond to those for MKDER, with zero for success 
or a negative value for errors. An important error message should be 
mentioned at this point. It is the message -36 (SFFFFFFCA). This is the 
error message you get when the subdirectory you are trying to remove 
contains files. 

Only empty subdirectories can be removed with RMDIR. In the event of the 
described error message, one must first erase all of the files in the directory 
with UNLINK ($41) and then call RMDIR again. 
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$3B CHDIR 

The system of subdirectories available under GEMDOS is exactly the same 
form available under UNIX. This system is now running on systems with 
diskette drives, but its advantages become noticeable first when a large mass 
storage device such as a hard disk with several megabytes of storage 
capacity is connected to the system. After a while, most of the time would 
probably be spent looking for files in the directory. 

To better organize the data, subdirectories can be placed within 
subdirectories. It can therefore become necessary to specify several 
subdirectories until one has the directory in which the desired file is stored. 
An example might be: 

/hugos . dat /cf lies . s/csorts . s/cqsort . s 

Translated this would mean: load the file cqsort . s from the subdirector)' 
csort s . s. This subdirectory c sorts . s is found in the subdirectory 
cf iles . s, which in turn is a subdirectory of hugos . dat. If the whole 
expression is given as a filename, the desired file will actually be loaded 
(assuming that the file and all of the subdirectories are present). If you want 
to access another file via the same path (do you understand the term 
pathname?), the entire path must be entered again. But you can also make 
the subdirectory specified in the path into the current directory, by calling 
CHDIR with the specification of the desired path. After this, all of the files 
in the selected subdirectory can be accessed just by the filenames. The path 
is set by the function. 


MOVE . L #path,-(SP) 
MOVE . W #$3B, - (SP) 
TRAP #1 
ADDQ.L #6, SP 
TST.W DO 
BNE error 


* Address of the path 

* Function number 

* Repair stack 

* Error occurred? 

* Apparently 


path : 

.dc .b * /hugos .dat /private .dat/ 1 , 0 
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$3C CREATE 

In all operating systems, the files are accessed through the sequence of 
opening the file, accessing the data, (reading or writing), and then dosing 
the file. This ’'trinity" also exists under GEMDOS, although there is an 
exception. Under CP/M, for example, a non-existing file can also be 
opened. When a file which does not exist is opened, it is created. Under 
GEMDOS, the file must first be created. The call $3C, CREATE, is used 
for this purpose. Two parameters are passed to this GEMDOS function: the 
address of die desired filename, and an attribute word. 

If a zero is passed as the attribute word, a normal file is created, a file which 
can be written to as well as read from. If the value 1 is passed as the 
attribute, the file will only be able to be read after it is closed. This is a type 
of software write-protect (which naturally cannot prevent the file from 
disappearing if the disk is formatted). 

Other possible attributes are $02, $04, and $08. Attribute $02 creates a 
"hidden" file and attribute $02 a "hidden" system file. Attribute $08 creates 
a file with a "volume label." The volume label is the (optional) name which 
a disk can be given when it is formatted. The disk name is then created from 
the maximum of 11 characters in the name and the extension. Files with one 
of the last three attributes are excluded from the normal directory search. On 
the ST, however, they do appear in the directory. 

When the function CREATE is ended, a file descriptor, also called a file 
handle, is returned in DO. All additional accesses to the file take place over 
this file handle (a numerical value bewteen 6 and 45). The handle must be 
given when reading, writing, or closing files. A total of $28 = 40 files can 
be opened at the same time. 

If CREATE is called and a file with this name already exists, it is cut off at 
zero length. This is equivalent to the sequence delete the old file and create a 
new file with the same name, but it goes much faster. 

If after calling CREATE you get a handle number back in DO, the file need 
not be opened again with $3D OPEN. 
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MOVE . W #$G,-{SP) 

MOVE . L #f ilename,- (SP) 
MOVE . W #$3C, — (SP) 

TRAP #1 
ADDQ.L #8, SP 
TST DO 
BMX error 
MOVE DO, handle 


* File should have R/W status 

* Address of the filename on stack 

* Function number 

* Call GEMDOS 

* Clean up stack 

* Error occurred? 

* It appears so 

* Save file handle 


filename: 

• dc .b 


* Don't forget zero byte 
'myfile.dat ' , 0 


handle : 

. ds . w 1 


$3D OPEN 

You can create only new files with CREATE, or shorten existing files to 
length zero. But you must be able to process existing files further as well. 
To do this, such files must be opened with the OPEN function. 

The first parameter of the OPEN function is the mode word. With a zero in 
the mode word, the opened file can only be read, with one it can only be 
written. With a value of 2, the file can be read as well as written. The 
filename, terminated with zero byte in the usual manner, is passed as the 
second parameter. 

The OPEN function returns the handle number in DO as the result if the file 
is present and the desired access mode is possible. Otherwise DO contains 
an error number. See the end of the chapter for a list of the error numbers. 
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MOVE . W 

#$2,-{SP) 

* 

File read and write 

MOVE . L 

#f ilename 

* 

Address of the filename on the stack 

MOVE . W 

#$3D, - (SP) 

* 

Function number 

TRAP 

#1 

* 

Call GEMDOS 

ADDQ.L 

#8, SP 

* 

Clean up the stack 

TST.W 

DO 

* 

Error occurred? 

BMI 

error 

* 

Appa rently 

MOVE 

DO, handle 

* 

Save file handle for later accesses 


filename: 

.dc .b 


* Don't forget zero byte! 
'myf ile .dat * , 0 


handle : 

. ds . w 1 


$3E CLOSE 

Every opened file should be closed when it will no longer be accessed 
within a program, or when the program itself is ended. Especially when 
writing, files must absolutely be closed before the program ends or data 
may be lost. 

Files are closed by a call to CLOSE, to which the handle number is passed 
as a parameter. The return value will be zero if the file was closed correctly. 


MOVE . W handle, - (SP) 
MOVE . W #$3E,— (SP) 
TRAP #1 
ADDQ.L #4, SP 
BMI error 

handle : 

. ds . w 1 


* Handle number 

* Function number 

* Call GEMDOS 

* Error occurred? 

* Apparently 
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$3F READ 

Opening and closing files is naturally only half of the matter. Data must be 
stored and the retrieved later. Reading such files can be done in a very 
elegant manner with the function READ. READ expects three parameters: 
first the address of a buffer in which the data is to be read, then the number 
of bytes to be read from the file, and finally the handle number of the file. 
This number you have (hopefully) saved from the previous OPEN. 

We mentioned the possible handle numbers in conjunction with CREATE. 
What we didn't mention, however, is why the first handle number is six. 
The cause of this is that things called devices, like the keyboard, the screen, 
the printer, and the serial interface, are also accessed via handle numbers for 
READ and WRITE operations. The device assignments are: 

0 = Console input 

1 = Console output 

2 = RS-232 

3 = Printer 

Numbers 4 and 5 also function as console input and output. When using 
these handle numbers, the system sometimes returns "invalid handle 
number". The correct programming and the exact purpose of these two 
numbers is not known. 

As return value, DO contains either an error number (hopefully not) or the 
number of bytes read without error. No message regarding the end of the 
file is returned. This is not necessary, however, since the size of the file is 
contained in the directory entry (see SEARCH FIRST/SEARCH NEXT). If 
the file is read past the logical end, no message is given. The reading will be 
interrupted at the end of the last occupied allocation unit of the file. The 
number of bytes read in this case is always divisible by $400. 
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MOVE.L tbuffer,- (SP) * 

MOVE.L #$100,- (SP) * 

MOVE.W handle,- (SP) * 

MOVE.W #$3F,-(SP) * 

TRAP #1 
ADD.L #12, SP 
TST.L DO * 

BMI error * 


Address of the data buffer 
Read 256 bytes 
Space for the handle number 
Function number 

Did an error occur 
Apparently 


handle : 

.ds.w 1 * Space for the handle number 

buffer: 

.ds.b $100 * Suffices in our example 


$40 WRITE 

Writing to a file is just as simple as reading from it The parameters required 
are also the same as those required for reading. The file descriptors from 
OPEN and CREATE calls can be used as the handle, but the device 
numbers listed for READ can also be used. The output of a program can be 
sent to the screen, the printer, or in a file just by changing the handle 
number. 


$41 UNLINK 

Files which are no longer needed can be deleted with UNLINK. To do this, 
the address of the filename or, if necessary, the complete pathname must be 
passed to the function. If the DO register contains a zero after the call, the 
file has been deleted. Otherwise DO will contain an error number. 
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MOVE . L 

pathname , - { SP ) * 

Address of the data buffer 

MOVE . W 

#$41,- 

(SP) * 

Function number 

TRAP 

#1 



ADD . L 

#6, SP 



TST.W 

DO 

* 

Did an error occur? 

BMI 

error 

* 

Apparently 

pathname : 




.dc -b 

* / rolli/private/pacman.prg' , 0 


$42 LSEEK 

Up to now we have become acquainted only with sequential data accesses. 
We can read through any file from the beginning until we come the desired 
information. An internal file pointer which points to the next byte to be read 
goes along with each read. We can only move this pointer continuously in 
the direction of the end of file by reading. A few bytes forward or 
backward, setting the pointer as desired, is not something we can do. This 
is required for many applications, however. 

LSEEK offers an extraordinarily easy-to-use method of setting the file 
pointer to any desired byte within the file and to read or write at this 
point.This UNIX-compatible option of GEMDOS is much easier to use that 
the methods available under CP/M for relative file management, for 
instance. 

A total of three parameters are passed to the LSEEK function. The first 
parameter specifies the number of bytes by which the pointer should be 
moved. An additional parameter is the handle number of the file. The last 
parameter is a mode word which describes how the file is to be moved. A 
zero as the mode moves the pointer to the start of the file and from there the 
given number of bytes toward the end of the file. Only positive values may 
be used as the number. With a mode value of 1, the pointer is moved the 
desired positive or negative amount from the current position, and a 2 as the 
mode value means the distance specified is from the end of the file. Only 
negative values are allowed in this mode. 
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After the call, DO contains the absolute position of the pointer from the start 
of the file, or an error message. 


MOVE .W 

#1,-(SP) 

* 

Relative from the current 

MOVE . W 

handle, — (SP) 

* 

File handle 

MOVE . L 

#$-20, -(SP) 

* 

32 bytes back 

MOVE . W 

#$42, -(SP) 

* 

Function number 

TRAP 

#1 



ADD -L 

#10, SP 



TST.W 

DO 

* 

Did an error occur? 

BMI 

error 

* 

Apparently 


handle : 

.ds.w 1 


* Space for the handle number 


$43 CHANGE MODE (CHMOD) 

With the CREATE function a file can be assigned a specific attribute. This 
attribute can be determined and subsequently changed only with the function 
CHANGE MODE. The name of the file must be known because the address 
of the name or the complete pathname must be passed to CHMOD. Another 
parameter word specifies whether the file attribute is to be read or set. 
Moreover, a word must be passed which contains the new attribute. When 
reading the attribute of a file this word is not necessary, but should be 
passed to the routine as a dummy value. We indicated the possible file 
attributes in our discussion of the function CREATE, but here they are again 
in a table: 

$00 = normal file status, read/write possible 
$01 = File is READ ONLY 
$02 = "hidden" file 
$04 = system file 

$08 = file is a volume label, contains disk name 

$10 = file is a subdirectory 

$20 = file is written and closed correctly 

Attributes $10 and $20 cannot be specified when the file is created. Attribute 
$20 is granted by the operating system, while the GEMDOS function 
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MKDIR is used to create a subdirectory. The MKDIR function creates not 
only the directory entry with the appropriate attribute, it also arranges the 
subdirectory on the disk physically. 

After the call, DO will contain the current attribute value, which will be the 
new value after setting the attribute, or, as with all other function calls, a 
negative error number. 


First example: 

MOVE . W #1,-(SP) 
MOVE . W #1,-{SP) 
MOVE.L #pathname, 
MOVE . W #$43,- (SP) 
TRAP #1 
ADD . L #10, SP 
TST.W DO 
BMI error 


pathname: * Don’t forget zero byte at end! 

.dc.b ’ killme.not*,0 

Second example: 

MOVE . W #0,-(SP) * Dummy value, not actually required 

MOVE . W #0,-(SP) * Read attribute 

MOVE.L #pathname,-(SP) * and the pathname 

MOVE . W #$43, -(SP) * Function number 

TRAP #1 

ADD . L #10, SP 

TST.W DO * Did an error occur? 

BMI error * Apparently 


pathname: * Don’t forget zero byte at the end! 

.dc.b 'what-am.i’,0 


* Give file READ ONLY attribute 

* Set attribute 

-(SP) * We also need the pathname 

* Function number 


* Did an error occur? 

* Apparently 
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•V 


$45 DUP 

As mentioned in connection with the functions READ and WRITE, the 
devices console, line printer, and RS-232 are also available to the 
programmer. This permits input and output to be redirected to these devices. 
One of the devices can be assigned a file handle number with the DUP 
function. After the call the next free handle number is returned. 


$46 FORCE 

The FORCE function allows further manipulation of the handle numbers. If 
in a program the console input and output are used exclusively via the 
READ and WRITE functions with the handle numbers 0 and 1, the input or 
output can be redirected with a call to this function. Screen outputs are 
written to a file, inputs are not taken from the keyboard, but from a 
previously-opened file. 


$47 GETDIR 

A given subdirectory can be made into the current directory with the 
function $37. All file accesses with a pathname then run only in the set 
subdirectory. Under certain presumptions it can be possible to determine the 
pathname to the current subdirectory. This is accomplished by the function 
call GETDIR, $47. This call requires the designation of the desired disk 
drive (0=current drive, 1 -drive A, 2=drive B, etc.) and a pointer to a 
64-byte buffer. The complete pathname to the current directory will be 
placed in this buffer. The pathname will be terminated by a zero byte. If the 
function is called when the main directory is active, no pathname will be 
returned. In this case, the first byte in the buffer will contain zero. After the 
call, DO must contain the value zero. If the value is negative, an error 
occurred, for example if an incorrect drive number was passed. 


128 




Abacus Software 


Atari ST Internals 


MOVE . W #G,-(SP) 

MOVE . L #buf fer, - (SP) 
MOVE . W #$ 47 (SP) 
TRAP #1 
ADDQ.L #8, SP 
TST.L DO 
BNE error 


* Get pathname of the current drive 

* Address of the 64-byte buffer 

* Function number 


* Error? 

* D0O0 if error 


buffer: 

.ds.b 64 * Buffer for pathname 


$48 MALLOC 

The MALLOC function and the two that follow it, MFREE and 
SETBLOCK, are concerned with the memory organization of GEMDOS. 
As already mentioned in conjunction with function $31, KEEP PROCESS, 
a program is assigned all of the entire memory space available after it is 
loaded. This is uncritical in many cases, because only a single program is 
running. But there are applications under GEMDOS in which such 
organization is not sensible. An accessory such as the VT-52 emulator may 
be called from within a program, for example. Such a program also requires 
memory space, but the memory might not be available. No further program 
modules can be loaded if the entire memory is occupied. For this reason, 
each program should reserve only the space which it actually needs for the 
program and data. The memory not required can be given back to 
GEMDOS. 

If the program should need some of the memory it gave back, it can request 
memory from GEMDOS via the function MALLOC (memory allocate). The 
number of bytes required is passed to MALLOC. After the call, DO contains 
the starting address of the memory area reserved by the call or an error 
message if an attempt is made to reserve more memory than is actually 
available. 

If -1L is passed as the number of bytes to be allocated, the number of bytes 
available is returned in DO. 


129 



Abacus Software 


Atari ST Internals 


First example: 

MOVE . L #-l,-(SP) 
MOVE . W #$48, — (SP) 
TRAP #1 
ADDQ.L #6, SP 


Second example: 

MOVE . L #$1000 / -(SP) 
MOVE . W #$48, -(SP) 
TRAP #1 
ADDQ.L #6, SP 
TST.W DO 
BMI error 
MOVE . L D0,mstart 


mstart : 

-ds.l 1 


* Determine number of free bytes 

* Function number 

* Number of free bytes in DO 


* Get hex 1000 bytes for the program 

* Function number 


* Error or address of memory? 

* Negative long word = error! 

* Else start addr of the reserved area 


$49 MFREE 

An area of memory reserved with MALLOC can be released at any time 
with MFREE. To do this, GEMDOS is passed the address of the memory 
to be released. The value will usually be the address returned by MALLOC. 

If a value of zero is returned in DO, the memory was released by GEMDOS 
without error. A negative values indicates errors. 
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* Addr of a previously allocated area 

* Function number 

* Number of free bytes in DO 

* Error? 

* DCOO is error! 


mstart : 

.ds.l 1 


MOVE .L mstart,- (SP) 
MOVE . W #$49, -<SP) 
TRAP #1 
ADDQ.L #6, SP 
TST.L DO 
BNE error 


$4A SETBLOCK 

In contrast to the MALLOC function, a specific area of memory can be 
reserved with the function SETBLOCK. The memory beginning at the 
specified address is returned to GEMDOS, even if it was reserved before. 
This function can be used to reserve the actual memory requirements of a 
program and release the remaining memory. 

The parameters the function requires are the starting address and the length 
of the area to be reserved. The area specified with these parameters is then 
reserved by GEMDOS and is not released again until the end of the program 
or after calling the MFREE function. 

Usually programs will begin with the following command sequence or 
something similar. After the call, DO must contain zero, otherwise an error 
occurred. 
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MOVE . L A7,A5 
MOVE . L #USTCK,A7 
MOVE . L 4<A5),A5 

MOVE . L $C(A5),D0 
ADD.L $14 (A5) , DO 

ADD .L $1C(A5),D0 

ADD.L #$100, DO 
MOVE . L DO , - (SP) 

MOVE . L A5, - (SP) 

MOVE . W #0,-(SP) 
MOVE . W #$4A, — (SP) 
TRAP #1 
ADD.L #12, SP 
TST.L DO 
BNE error 


* Save stack pointer in A5 

* Set up stack for the program 

* A5 now points to the base-page start 

* exactly $100 bytes below the prg start 

* $C(A5) contains length of the prg area 

* $14<A5) containg the length of the 

* initialized data area 

* $1C(A5) contains length of the 

* uninitialized data area 

* Reserve $100 bytes base page 

* DO contains the length of the area 

* to be reserved 

* A5 contains the start of the area 

* to be reserved 

* Meaningless word, but still necessary! 

* Function number 

* Clean up the stack as usual 

* Did an error occur? 

* Stop 

* Here the program continues . . . 


$4B EXEC 

The EXEC function permits loading and chaining programs. If desired, the 
program loaded can be automatically started. In addition to the function 
number, the addresses of three strings and a mode word are expected on the 
stack. 

The first address is a pointer to something called an ’’environment'' string, a 
string which describes the "environment." If the environment is not set, the 
address of a null string, the address of a zero byte, will suffice. 

The second pointer contains a command line for the program being called. A 
command line is comparable to the line which may be entered from the 
command mode when you have selected the point "TOS -takes parameters" 
from the option "Options". 
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The third pointer points to the filename or pathname of the file. All three 
strings must be terminated with a zero byte or consist of only a zero byte. 

The mode word can be either zero or three. The standard value zero starts 
the loaded program automatically, while a three loads the program without 
automatically executing it. In this last case, either the address of the base 
page or an error message is returned in DO. 


MOVE . L 

#env, - 

(SP) 

* 

Environment 

MOVE . L 

#com, - 

(SP) 

* 

Command line 

MOVE . L 

#f il, - 

(SP) 

* 

Filename 

MOVE . W 

#0,-<SP) 

* 

Load and start, please 

MOVE . W 

#$4B,- 

(SP) 

★ 

Function number 

TRAP 

#1 




AJDD.L 

#14, SP 


* 

Here we come to the end of the 

• 



* 

chained program or postloaded module 

fil: 



* 

Load sort routine 


.dc.b 

■qsort 

.prg',0 

com: 



* 

Sort the file in ascending order 


.dc.b 

'up data 

•asc 1 , 0 

env: 

.dc.b 

0 

* 

No environment 


$4C TERM 

TERM $4C represents the third method, after TERM $00 and TERM $31, 
of ending a program. TERM $4C automatically makes the memory used by 
the program available to GEMDOS again. Different from TERM $00, 
however, a programmer-defined return value other than zero can be returned 
to the caller. This allows a short message to be passed back to the calling 
program. 
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MOVE . W #37, -MSP) 
MOVE . W #$4C,-(SP) 
TRAP #1 


* Any 2 -byte value 

* End program 

* now 

* We never get here 


$ 4E SFIRST 

The SFIRST function can be used to check to see if a file with the given 
name is present in the directory. If a file with the same name is found, the 
filename, the file attribute, data and time of creation, and the size of the file 
in bytes is returned. This information is placed in the DTA buffer, whose 
address is set with the SETDTA function, by GEMDOS. 

One feature of this function is that the filename need not be specified in its 
entirety. Individual characters in the filename can be exchanged for a 
question mark but entire groups of letters can also be replaced by a 
In the extreme form a filename would be reduced to the string In this 
case the first file in the directory would satisfy the conditions and the 
filename would appear in the DTA buffer along with the other information. 

In addition to the filename, the SFIRST function must also be given a 
search attribute. The possible parameters of the search attribute correspond 
to the attributes which can be specified in CHMOD function: 

$00 = Normal access, read/write possible 

$01 = Normal access, write protected 

$02 = Hidden entry (ignored by the ST desktop) 

$04 = Hidden system file (ignored like $02) 

$08 = Volume label, diskette name 
$10 = Subdirectory 

$20 = File will be written and closed 

The following rules apply when searching for files: 

If the attribute word is zero, only normal files are recognized. 
System files or subdirectories are not recognized. 

System files, hidden files, and subdirectories are found when 
the corresponding attribute bits are set. Volume labels are not 
recognized, however. 
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In order to get the volume label, this option must be expressly 
set in the attribute word. All other files are then ignored. 

After the call, DO contains the value zero if a corresponding file 
has been found. In this case the 44-byte DTA buffer is 
constructed as follows: 


Bytes 

0-20 

Byte 

21 

Bytes 

22-23 

Bytes 

24-25 

Bytes 

2 6-29 

Bytes 

30-43 


Reserved for GEMDOS 

File attribute 

Clock time of file creation 

Date of file creation 

File size in bytes (long) 

Name and extension of the file 


If, however, no file is found which corresponds to the specified search 
string, the error message -33, file not found, is returned. 


MOVE . L #dta,-(SP) 
MOVE . W #1A,-(SP) 

TRAP #1 

ADDQ.L #6, SP 

MOVE . w #attrib, - (SP) 

MOVE . L #filnam,-<SP) 

MOVE.W #$4E,-(SP) 

TRAP , #1 

ADDQ.L #8, SP 

TST DO 

BNE not found 


* Set up DTA buffer 

* Function number SETDTA 


* Attribute value 

* Name of file to search for 

* Function number 


* File found? 

* Apparently not 


attrib: 

.dc.b 0 * Search for normal files only 

f ilnam: 

.dc.b **.**, 0 * Search for the 1st possible file 


dta : 


.ds.b 44 * Space for the DTA buffer 
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$4F SNEXT 

The SNEXT function (Search next) can be used to see if there are other files 
on the disk which match the filename given. To do this, only the function 
number need be passed; SNEXT does not require any parameters. All of the 
parameters are set from the SFIRST call. 

If the search string is very global, as in the previous example, all of the files 
on a diskette can be determined and displayed one after the other with 
SFIRST and SNEXT. This makes it rather easy to display a directory 
within a program. The SNEXT function is called repeatedly and the 
contents of DO are check afterwards. If DO contains a value other than zero, 
either an error occurred, or all of the directoiy entries have been searched. 


$56 RENAME 

A RENAME function is found in almost every disk-oriented operating 
system in one form or another, since renaming files is required fairly often . 
Under GEMDOS, files are renamed with the RENAME function, which 
requires two pointer to file or pathnames. The first pointer points to the new 
name, with the specification of the pathname of the file if necessary, and 
the second pointer points to the previous name. A 2-byte parameter is 
required in addition to the two pointers. We were not able to determine the 
significance of the additional word parameter. Different values had no 
(recognizable) effect 

As a return value, DO contains either zero, meaning that the name was 
changed correctly, or an error code. 
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MOVE . h #newnam, - (SP ) 
MOVE . L toldname, - (SP) 
MOVE .W #0,-(SP) 

MOVE . W #$56 f - (SP) 

TRAP #1 
ADD.L #12, SP 
TST.L DO 


* New filename 

* File to rename 

* Dummy? 

* Function number 


* Test for error 


oldnam: * Don't forget zero byte at end! 

.dc.b ‘oldf ile -dat ' , 0 

newnam: 

. dc . b ' newname . dat 1 , 0 


$57 GSDTOF 

If the directory is displayed as text rather than icons on the desktop, the date 
and time of file creation as well as the size of the file in bytes is shown. The 
time and date can either be set or read with function $57. To do this it is 
necessary that the file be already opened with OPEN or CREATE. The 
handle number obtained at the opening must be passed to the function. 
Additional parameters are a word which acts as a flag as to whether the time 
and data are to be set (0) or read (1), and a pointer to a 4-byte buffer which 
either contains the result data or will be provided with the required data 
before the call. 

This date buffer contains the time in the first two byes and the date in the 
last two. The format of the data is identical to that of the functions for 
setting/reading the time and date. 


137 


Example 1: 


MOVE.W #1,-(SP) * Read time and date 

MOVE.W #handle,— (SP) * File must first be opened 
MOVE . L #buff,— (SP) * 4 byte buffer 
MOVE.W #$57,— (SP) * Function number 
TRAP #1 
ADD . L #10, SP 


handle : 

.ds.b 2 

buff : 

-ds.b 4 


Example 2: 

MOVE.W #0,- (SP) * Set time and date 

MOVE.W #handle, - (SP) * File must first be opened 

MOVE . L #buff (SP) * 4 byte buffer 

MOVE.W #$57, -(SP) * Function number 

TRAP #1 

ADD .L #10, SP 


handle : 

-ds.b 2 

buff : 

.ds.b 4 
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3.1.1 GEMDOS error codes and their meaning 


The GEMDOS functions return a value giving information about whether or 
not an error occurred during the execution of the function. A value of zero 
means no error; negative values have the following meanings: 

-32 Invalid function number 
-33 File not found 
-34 Pathname not found 

-35 Too many files open {no more handles left) 

-36 Access not possible 

-37 Invalid handle number 

-39 Not enough memory 

-40 Invalid memory block address 

-46 Invalid drive specification 

-49 No more files 

In addition to these error messages, the BIOS error messages may occur. 
These error messages have numbers -1 to -31 and are described in section 
3.3 
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3.2 The BIOS Functions 


The software interface between the GEMDOS and the hardware of the 
computer is the BIOS (Basic Input Output System). The BIOS, as the name 
suggests, is concerned with the fundamental input/output functions. This 
includes screen output, keyboard input, printer output, as well as the 
RS-232 interface and, of course, input/output to the disk. 

The BIOS functions are also available to user programs. The trap 
instruction of the 68000 processor is used to call them. Any data required is 
passed through the stack and the result of the function is returned in the DO 
register. The machine language programmer should be aware that the 
contents of D0-D2 and A0-A2 are changed when calling BIOS functions; 
the remaining registers remain unchanged. 

BIOS function calls are even simpler if you program in C. Here you can use 
simple function calls with the corresponding parameter lists. The function 
calls are stored as macros in an include file. In the examples, the definition 
of the function and its parameters in C will be shown. For assembly 
language programmers, the use is described in an example. 

TRAP # 13 is reserved for the BIOS functions. 
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0 getmpb 


get memory parameter block 


C: void getmpb (pointer) 
long pointer; 


Assembler: 


raove.l pointer, - (SP) 
move.w #0,— (SP) 
trap #13 
addq.l #6,sp 


This function fills a 12-byte block whose address is contained in pointer 
with the memory parameter block. This block contains three pointers itself: 


long mfl 
long mal 
long rover 


Memory free list 
Memory allocated list 
Roving pointer 


The structures to which each pointer points are constructed as follows: 


long 

link 

Pointer to next block 

long 

start 

Start address of the block 

long 

length 

Length of the block in bytes 

long 

own 

Process descriptor 

Example: 

move . 1 

tbuffer,- (sp) 

Buffer for MPB 

move . w 

#0, - (sp) 

getmpb 

trap 

#13 

Call BIOS 

addq . 1 

#6, sp 

Stack correction 

We get the 

values $48E, 0, 

and $48E. The following data are at 

$48E: 

link 

0 

No additional block 

start 

$3B900 

Start address of the free me 

length 

$3C700 

Length of the free memory 

own 

0 

No process descriptor 
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1 bconstat return input device status 

C: int bconstat (dev) 
int dev; 

Assembler: 


move.w dev,-(sp) 
move.w #1,— (sp) 
trap #13 
addq.l #4,sp 


This function returns the status of an input device which is defined as 
follows: 


Status 0 No characters ready 

Status -1 (at least) one character ready 

The parameter dev specifies the input device: 

dev Input device 

0 PRT : , Centronics interface 

1 AUX : , RS-232 interface 

2 CON : , Keyboard and screen 

3 MIDI, MIDI interface 

4 IKBD, Keyboard port 

The following table lists the allowed accesses to these devices: 


Operation 

PRT: 

AUX: 

CON: 

MIDI 

IKBD 

Input status 

no 

yes 

yes 

yes 

no 

Input 

yes 

yes 

yes 

yes 

yes 

Output status 

yes 

yes 

yes 

yes 

yes 

Output 

yes 

yes 

yes 

yes 

yes 


This example waits until a character from the RS-232 interface is ready. 


wait move.w #l,-(sp) 
move.w #l,-(sp) 
trap #13 
addq.l #4,sp 
tst dO 
beq wait 


RS-232 

bconstat 


character available? 
no, wait 
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2 conin 


read character from device 


C: long conin (dev) 
int dev; 

Assembler: 


move.w dev,-{sp) 
move.w #2,-(sp) 
trap #13 
addq.l #4,sp 

This function fetches a character from an input device. The parameter dev 
has the same meaning as in the previous function. The function does not 
return until a character is ready. 

The character received is in the lowest byte of the result. If the input device 
was the keyboard (con, 2), the key scan code is also returned in the lower 
byte of the upper word (see description of the keyboard processor). 


Example: 

move.w #2, - (sp) con 

move.w #2,-(sp) bconin 

trap #13 
addq.l #4,sp 
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3 bconout write character to device 

C: void bconout (dev, c) 
int dev, c; 

Assembler: 


move.w c, — (sp) 
move.w dev,-(sp) 
move.w #3,-(sp) 
trap #13 
addq.l #6,sp 


This function serves to output a character "c" to the output device dev 
(meaning is the same as for the previous function). The function returns 
when the character has been outputted. 

Example: 


move.w # * A ‘ — (sp) 
move.w #0, - (sp) PRT: 

move.w #3,-(sp) bconout 

trap #13 
addq.l #6,sp 

The example outputs the letter "A” to the printer. 
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4 rwabs read and write disk sector 

C: long rwabs (bwf lag, buffer, number, recno, dev) 
long buffer; 

int rwflag, number, recno, dev; 

Assembler: 

jnove.w dev,-(sp) 
move.w recno, -(sp) 
move.w number, - (sp) 
move.l buffer, -<sp) 
move.w rwflag, -(sp) 
move.w #4,-(sp) 
trap #13 
add. 1 #14, sp 

This function serves to read and write sectors on the disk. The parameters 
have the following meaning: 

rwflag Meaning 

0 Read sector 

1 Write sector 

2 Read sector, ignore disk change 

3 Write sector, ignore disk change 

The parameter buffer is the address of a buffer into which the data will be 
read from the disk or from which the data will be written to the disk. The 
buffer should begin at an even address, or the transfer will run very slowly. 

The parameter number specifies how many sectors should be read or written 
during the call. The parameter recno specifies which logical sector the 
process will start with. 

The parameter dev determines which disk drive will be used: 

dev Drive 

0 Drive A 

1 Drive B 

2 Hard disk 
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The function returns an error code as the result. If this value is zero, the 
operation was performed without error. The returned value will be negative 
if an error occunred. The error code has the following meaning: 

0 0K f no error 
-1 General error 
-2 Drive not ready 
-3 Unknown command 
-4 CRC error 

-5 Bad request, invalid command 
-6 Seek error, track not found 
-7 Unknown media (invalid boot sector) 

-8 Sector not found 
-9 {No paper) 

-10 Write error 

-11 Read error 

-12 General error 

-13 Diskette write protected 

-14 Diskette was changed 

-15 Unknown device 

-16 Bad sector (during verify) 

-17 Insert diskette (for connected drive) 


Example: 


move.w #0,-(sp) 
move.w #10, -(sp) 
move.w #2,-(sp) 
move.l #buf fer, - (sp) 
move.w #0,-(sp) 
move.w #4, - (sp) 
trap #13 
add.l #14, sp 

buffer ds.b 2*512 


Drive A 

Start at logical sector 10 

Read 2 sectors 

Buffer address 

Read sectors 

rwabs 
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5 Setexec set exception vectors 

C: long setexec (number, vector) 
int number; 
long vector; 

Assembler: 


move . 1 vector,- (sp) 
move.w number, - (sp) 
move.w #5,-(sp) 
trap #13 
addq.l #8,sp 

The function setexec allows one of the exception vectors of the 68000 
processor to be changed. The number of the vector must be passed in 
number and the address of the routine pertaining to it in vector. The 
function returns the old vector as the result. If you just want to read the 
vector, pass the value -1 as the new address. The 256 processor vectors as 
well as 8 vectors for GEM, which numbers $100 to $107 (address $400 to 
$4 1C) can be changed with this function. 

Example: 


move.l Ibuserror,- (sp) 
move.w #2,-{sp) 
move.w #5, - (sp) 
trap #13 
addq.l #8,sp 

buserror 
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6 tick cal return millisecond per tick 

C: long tick.cal() 

Assembler: 

move.w #6,-(sp) 
trap #13 
addq.l #2,sp 

This function returns the number of milliseconds between two system timer 
calls. 

Example: 


move.w #6,-(sp) 
trap #13 
addq.l #2,sp 

Result: 20 ms 
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7 getbpb get BIOS parameter block 

C: long getbpb (dev) 
int dev; 

Assembler: 


move.w dev,— (sp) 
move.w #7,-(sp) 
trap #13 
addq.l #4,sp 


This function returns a pointer to the BIOS Parameter Block of the drive 
dev (0=drive A, l=drive B). 


The BPB (BIOS Parameter Block ) is constructed as follows: 


int 

recsiz 

int 

clsiz 

int 

clsizb 

int 

rdlen 

int 

f siz 

int 

fatrec 

int 

datrec 

int 

numcl 

int 

bf lags 


Sector size in bytes 

Cluster size in sectors 

Cluster size in bytes 

Directory length in sectors 

FAT size in sectors 

Sector number of the second FAT 

Sector number of the first data cluster 

Number of data clusters on the disk 

Misc. flags 


The function returns the address $3E3E for drive A and the address $3E5E 
for drive B. An address of zero indicates an error. 


Example: 

move.w #0,-(sp) Drive A 

move.w #7,-(sp) getbpb 

trap #13 
addq.l #4,sp 
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Here are the BPB data for 80 track single and double-sided disk drives: 


Parameter 

80 track SS 

80 track 

recsiz 

512 

512 

clsiz 

2 

2 

clsizb 

1024 

1024 

rdlen 

7 

7 

f siz 

5 

5 

f atrec 

6 

6 

da tree 

18 

18 

numcl 

351 

711 
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8 bcostat return output device status 

C: long bcostat (dev) 
int dev; 

Assembler: 


move . w dev, - ( sp ) 
move.w #8,-(sp) 
trap #13 
addq.l #4,sp 


This function tests to see if the output device specified by dev is ready to 
output the next character, dev can accept the values which are described in 
function one. The result of this function is either -1 if the output device is 
ready, or zero if it must wait 

Example: 

Printer ready? 
bcostat 


move.w #0,-(sp) 
move.w #8,-(sp) 
trap #13 
addq.l #4,sp 
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9 mediach inquire media change 

C: long mediach (dev) 
int dev ; 

Assembler: 


move.w dev,— (sp) 
move . w #9,-<sp) 
trap #13 
addq.l #4,sp 


This function determined if the disk was changed in the meantime. The 
parameter dev, the drive number (0=drive A, l=drive B), must be passed to 
the routine. One of three values can occur as the result: 


0 Diskette was definitely not changed 

1 Diskette may have been changed 

2 Diskette was definitely changed 

Example: 

move.w #l,-(sp) Drive B 

move.w #9,-(sp) mediach 

trap #13 
addq.l #4,sp 
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10 drvmap inquire drive status 

C : long drvmap ( ) 

Assembler: 

sove.w #10,- (sp) 
trap #13 
addq.l #2,sp 


This function returns a bit vector which contains the connected drives. The 
bit number n is set if drive n is available (0 means A, etc.). Even if only one 
drive is connected, %11 is still returned, since two logical drives are 
assumed. 


Example: 


move.w #10, -(sp) drvmap 

trap #13 
addq .1 #2 , sp 
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11 kbshift inquire! change keyboard status 

C: long kbshift (mode) 
int mode ; 

Assembler: 

move.w mode,— (sp) 
mode . w # 1 1 , - ( sp ) 
trap #13 
addq.l #4,sp 

With this function you can change or determine the status of the special keys 
on the keyboard. If mode is -1, you get the status, a positive value is 
accepted as the status. The status is a bit vector which is constructed as 
follows: 

Bit Meaning 

0 Right shift key 

1 Left shift key 

2 Control key 

3 ALT key 

4 Caps Lock on 

5 Right mouse button (CLR/HOME) 

6 Left mouse button (INSERT) 

7 Unused 

Example: 

move.w #-l,~(sp) Read shift status 

move.w #11,- (sp) kbshift 

trap #13 
addq .1 # 4 , sp 
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3.3 The XBIOS 


To support the special hardware features of the Atari ST, there are extended 
BIOS functions, which are called via a TRAP #14 instruction. The 
functions, like the normal BIOS functions, can be called from assembly 
language as well as from C. When calling from C, a small TRAP handler in 
machine language is again necessary, which can look like this: 

trapl4 : 


move . 1 

(sp) +, retsave 

Save return address 

trap 

#14 

Call XBIOS 

move . 1 
rts 

retsave,- (sp) 

Restore return address 

-bss 

retsave ds.l 

1 

Space for the return address 


Macro functions can be used in C which allow the extended BIOS functions 
(extended BIOS, XBIOS) to be called by name. The appropriate function 
number and TRAP call will be created when the macro is expanded. 

When working in assembly language, the function number of the XBIOS 
routine need simply be passed on the stack. The XBIOS has 40 different 
functions whose signficance and use are described on the following pages. 
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0 initmous initialize mouse 

C: void initmous (type, parameter, vector) 
int type; 

long parameter, vector; 

Assembler: 


move.l vector, -(sp) 
move.l parameter,- (sp) 
move . w type,-(sp) 
move.w #0, (-sp) 
trap #14 
add. 1 #12, sp 


This XBIOS function initializes the routines for mouse processing. The 
parameter vector is the address of a routine which will be executed 
following a mouse-report from the keyboard processor, rhe parameter type 
selects from among the following alternatives: 


type 

0 Disable mouse 

1 Enable mouse, relative mode 

2 Enable mouse, absolute mode 

3 unused 

4 Enable mouse, keyboard mode 

This allows you to select if mouse movements are to be reported and in 
what manner this will occur. 

The parameter parameter points to a parameter block, which is constructed 
as follows: 


char topmode 
char buttons 
char xparam 
char yparam 


The parameter topmode determines the layout of the coordinate system. A 0 
means that Y=0 lies in the lower comer, 1 means that Y=0 lies in the upper 


comer. 
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The parameter buttons is a parameter for the command "set mouse 
buttons" of the keyboard processor (see description of the IKBD, intelligent 
keyboard). 

The parameters xparam and yparam are scaling factors for the mouse 
movement. If you have selected 2 as the type, the absolute mode, the 
parameter block determines four more parameters: 

int xmax 
int ymax 
int xstart 
int ystart 

These are the X and Y-coordinates of the maximal value which the mouse 
position can assume, as well as the start value to which the mouse will be 
set. 

Example: 

move . 1 Ivector, - (sp) 
move.l iparameter, - (sp) 
move.w #l,-(sp) 
move . w #0,-(sp) 
trap #14 
add.l # 12 , sp 

parameter dc.b 

vector . . . Mouse interrupt routine 


Address of the mouse position 
Address of the parameter block 
Enable relative mouse mode 
Init mouse 
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1 SSbrk save memory space 

C: long ssbrk (number) 
int number; 


Assembler: 


move.w number, -(sp) 
move.w #1,— (sp) 
trap #14 
addq.l #4,sp 


This function reserves memory space. The number of bytes must be passed 
in number. The memory space is prepared at the upper end of memory. The 
function returns the address of the reserved memory area as the result. This 
function must be called before initializing the operating system, meaning 
that is must be called from the boot ROM, before the operating system is 
loaded. 


Example: 

move.w #$400, -(sp) Reserve IK 

move.w #l,-(sp) ssbrk 

trap #14 
addq.l #4,sp 
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2 physbase return screen RAM base address 

C: long physbase {) 

Assembler: 

move #2,-(sp) 
trap #14 
addq.l #2,sp 

This function returns the base of the physical screen RAM. The physical 
screen RAM is the area of memory which is displayed by the video shifter. 
The result is a long word. 

Example: 

$78000, base address of the screen for 512K RAM 
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3 logbase set logical screen base 

C : long logbase () 

Assembler: 


move #3,-(sp) 
trap #14 
addq.l #2,sp 

The logical screen base is the address which is used for all output functions 
as the screen base. If the physical and logical screen bases are different, one 
screen will be displayed while another picture is being constructed in a 
different area of RAM, which will be displayed later. The result of this 
function call is again a longword. 

Example: 

$78000, base address of the screen for 512K RAM 
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4 getrez return screen resolution 

C: int getrez () 

Assembler: 

move.w #4, - (sp) 
trap #14 
addq.l #2,sp 

This function call returns the screen resolution: 

0 := Low resolution, 320*200 pixels, 16 colors 

1 := Medium resultion, 640*200 pixels, 4 colors 

2 := High resolution, 640*400, pixels, monochrome 

Example: 

2, monochrome 
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5 setscreen set screen parameters 

C: void setscreen (logadr, physadr, res) 
long logadr, physadr; 
int res; 

Assembler 


move.w res,-(sp) 
move.l physadr,- (sp) 
move.l logadr, -(sp) 
move.w #5,-<sp) 
trap #14 
add.l #12, sp 

This function changes the screen parameters which can be read with the 
previous three functions. If a parameter should not be set, a negative value 
must be passed. The parameters are set in the next VBL routine so that no 
disturbances appear on the screen. 

Example: 

Set the physical and the logical screen address to $70000, retain the 
resolution. 


move.w #-l,-(sp) 
move.l #$70000, - (sp) 
move.l #$70000,- (sp) 
move.w #5,-(sp) 
trap #14 
add.l #12, sp 


Retain resolution 
Physical base 
Logical base 
setscreen 
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6 setpalette set color palette 

C: void setpalette (paletteptr) 
long paletteptr; 

Assembler: 

move . 1 paletteptr,- (sp) 
move.w #6,-<sp) 
trap #14 
addq .1 # 6 , sp 

A new color palette can be loaded with this function. The parameter 
paletteptr must be a pointer to a table with 16 colors (each a word). The 
address of the table must be even. The colors will be loaded at the start of 
the next VBL. Example: 

move . 1 #palette,-(sp) Address of the new color palette 
move.w #6,-(sp) set palette 

trap #14 
addq.l #6,sp 

palette dc.w $777, $700, $070, $007, $111, $222, $333, $444, 
$555, $000, $001, $010, $100, $200, $020, $002, 

$123, $456 
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7 setcolor set color 


C: int setcolor (colornum, color) 
int colornum, color 

Assembler: 


move.w color, -<sp) 
move.w colornum, — (sp) 
move.w #7,-(sp) 
trap #14 
addq.l #6,sp 


This function allows just one color to be changed. The color number (0-15) 
and the color belonging to it (0-$777) must be specified. If -1 is given as the 
color, the color is not set but the previous color is returned. 

Example: 


move.w #$777,- (sp) Color white 

move.w #1, — (sp) As color number 1 

move.w #7, — (sp) 
trap #14 
addq.l #6,sp 
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8 floprd read diskette sector 

C: int floprd (buffer, filler, dev, sector, track, side, 
count ) 

long buffer, filler; 

int dev, sector, track, side, count; 

Assembler: 

move.w count, -(sp) 
move.w side,-(sp) 
move.w track, -(sp) 
move.w sector, -(sp) 
move.w dev, -(sp) 
clr.l -(sp) 
move.l buffer, -(sp) 
move.w #8,-(sp) 
trap #14 
add.l #20, sp 

This function reads one or more sectors in from the diskette. The parameters 
have the following meaning: 

count : Specifies how many sectors are to be read. V alues between 
one and nine (number of sectors per track) are possible. 

Side : Selects the diskette side, zero for single-sided drives and 

zero or one for double-sided drives. 

track: Determines the track number (0-79 for 80-track drives or 
0-39 for 40-track drives). 

sector : The sector number of the first sector to be read (0-9). 
dev : Determine drive number, 0 for drive A and 1 for drive B. 

filler: Unused long word. 

buffer: Buffer in which the diskette data should be written. The 
buffer must begin on a word boundary and be large enough 
for the data to be read (512 bytes times the number of 
sectors). 
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The function returns an error code which has the following meaning: 

0 OK, no error 
-1 General error 
-2 Drive not ready 
-3 Unknown command 
-4 CRC error 

-5 Bad request, invalid command 
-6 Seek error, track not found 
-7 Unknown media (invalid boot sector) 

-8 Sector not found 
-9 (No paper) 

-10 Write error 

-11 Read error 

-12 General error 

-13 Diskette write protected 

-14 Diskette was changed 

-15 Unknown device 

-16 Bad sector (during verify) 

-17 Insert diskette (for connected drive) 


Example: 


move.w #l,-(sp) 
move.w #0,-(sp) 
move.w #0,-(sp) 
move.w #l,-(sp) 
move.w #l,-(sp) 
clr.l -(sp) 
move . 1 #buf fer,- (sp) 
move.w #8,-(sp) 
trap #14 
add.l #20, sp 
tst dO 

bmi error 

buffer ds.b 512 


Read a sector 
Page zero 
Track zero 
Sector one 
Drive B 

f loprd 

Did error occur? 
yes 

Buffer for a sector 
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9 flopwr write diskette sector 

C: int floprd (buffer, filler, dev, sector, track, side, 
count ) 

long buffer, filler; 

int dev, sector, track, side, count; 


Assembler: 


move.w count, -(sp) 
move.w side,-(sp) 
move.w track, -(sp) 
move.w sector, -(sp) 
move.w dev,-(sp) 
clr.l -(sp) 
move.l buffer, -(sp) 
move.w #9,-(sp) 
trap #14 
add. 1 #20, sp 


One or more sectors can be written to disk with this XBIOS function. The 
parameters have the same meaning as for the function 8 floprd. The function 
returns an error code which also has the same meaning as for reading 
sectors. Example: 


move . w 

#3, - (sp) 

move . w 

#0,- (sp) 

move . w 

#7, - (sp) 

move . w 

#1, — (sp) 

move.w 

#0, - (sp) 

clr.l 

-(sp) 

move . 1 

#buffer,-(sp) 

move . w 

#9,- (sp) 

trap 

#14 

add. 1 

#20, sp 

tst 

dO 

bird 

error 

buffer ds.b 3*512 


Write three sectors 
Side zero 
Track seven 
Sector one 
Drive A 

Address of the buffer 
flopwr 

Did an error occur? 
yes 

Buffer for three sectors 
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10 fiopfmt format diskette 


C: int fiopfmt (buffer, filler, dev, spt, track, side, 
interleave, magic, virgin) 
long buffer, filler, magic; 

int dev, spt, track, side, interleave, virgin; 
Assembler: 


move . w 
move . 1 
move . w 
move . w 
move . w 
move . w 
move . w 
clr . 1 
move . 1 
move . w 
trap 
add. 1 


virgin, - (sp) 
magic, - (sp) 
interleave, - (sp) 
side, - (sp) 
track, - (sp) 
spt , — (sp) 
dev, - (sp) 

-(sp) 

buffer, -(sp) 

#10, -(sp) 

#14 

#26, sp 


This routine serves to format a track on the diskette. The parameters have 
the following meanings: 


virgin: 

The sectors are formatted with this value. The 
standard value is $E5E5. The high nibble of each byte 
may not contain the value $F. 

magic: 

The constant $87654321 must be used as magic or 
formatting will be stopped. 

interleave: 

Determines in which order the sectors on the disk will 
be written, usually one. 

side: 

Selects the disk side (0 or 1). 

track : 

The number of the track to be formatted (0-79). 

spt : 

Sectors per track, normally 9. 

dev: 

The drive, 0 for A and 1 for B. 
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filler: Unused long word. 

buffer : Buffer for the track data; for 9 sectors per track the 

buffer mst be at least 8K large. 

The function returns an error code as its result. The value -16, bad sectors, 
means that data in some sectors could not be read back correctly. ln 
case the buffer contains a list of bad sectors (word data, terminated by 
zero). You can format these again or mark the sectors as bad. 

Example: 


move . w 

#$E5E5,-(sp) 

Initial data 

move . 1 

#$87654321, -(sp) 

magic 

move . w 

#l,-(sp) 

interleave 

move . w 

# 0 ,- (sp) 

side 0 

move . w 

#79, -(sp) 

track 79 

move . w 

#9, - (sp) 

9 sector per track 

move . w 

#0, - (sp) 

drive A 

clr .1 

-(sp) 


move . w 

#buf fer, - (sp) 


move . w 

#10, - (sp) 

flopfmt 

trap 

#14 


add. 1 

#26, sp 


tst 

dO 


bmi 

error 



buffer ds.b $2000 8K buffer 


11 unused 
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12 midiws write string to MIDI interface 

C: void midiws (count, ptr) 
int count? 
long ptr; 

Assembler: 


move.l ptr,-(sp) 
move.w count, - (sp) 
move . w #12, -(sp) 
trap #14 
addq.l #8,sp 


With this function it is possible to output a string to the MIDI interface 
(MIDI OUT). The parameter ptr must point to a string, count must contain 
the number of characters to be sent minus 1. 


Example: 


move.l #string, - (sp) Address of the string 

move.w #stringend-string-l,-(sp) Length 

move.w #12, -(sp) midiws 

trap #14 

addq.l #8,sp 


string dc.b ’MIDI data" 
stringend equ * 
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13 mfpint initialize MFP format 

C: void mfpint (number, vector) 
int number; 
long vector; 

Assembler: 

move.l vector,- (sp) 
move.w number, -(sp) 
move.w #13, -(sp) 
t rap #14 
addq.l #8,sp 

This function initializes an interrupt routine in the MFP. The number of the 
MFP interrupt is in number while vector contains the address of the 
corresponding interrupt routine. The old interrupt vector is overwritten. 


Example: 


move . 1 

#busy,-(sp) 

Busy interrupt routine 

move . w 

#0, - (sp) 

Vector number 0 

move . w 

#13, -(sp) 

mfpint 

trap 

#14 


addq.l 

#8,sp 



busy: 
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14 iorec return record buffer 

C: long iorec (dev) 
int dev; 

Assembler: 

raove.w dev,— (sp) 
move.w #14, -(sp) 
trap #14 

addq.l #4,sp 

This function fetches a pointer to a buffer data record for an input device. 
The following input devices can be specified: 

dev Input device 

0 RS-232 

1 Keyboard 

2 MIDI 

The buffer record for an input device has the following layout: 

long ibuf Pointer to an input buffer 

int ibufsize Size of the input buffer 

int ibufhd Head index 

int ibuftl Tail index 

int ibuflow Low water mark 
int ibufhi High water mark 

The input buffer is a circular buffer; the head index specifies the next write 
position (the buffer is filled by an interrupt routine) and the tail index 
specifies from where the buffer can be read. If the head and tail indices are 
the same, the buffer is empty. The low and high marks are used in 
connection with the communications status for the RS-232 (XON/XOFF or 
RTS/CTS). If the input buffer is filled up to the high water mark, the 
sender is informed via XON or CTS that the computer cannot receive any 
more data. When data received by the computer can be processed again, so 
that the buffer contents sink below the low water mark, the transfer is 
resumed. 

There is an identically-constructed buffer record for the RS-232 output 
which is located directly behind the input record. 
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Example: 


move . w #l,-(sp) Buffer record for keyboard 

move.w #14, -(sp) iorec 

trap #14 
addq.l #4,sp 

Result: $9F2 


The following table contains the data for all devices: 


RS- 

-232 input 

Address 

$9D0 

Buffer address 

$6D0 

Buffer length 

$100 

Head index 

0 

Tail index 

0 

Low water mark 

$40 

High water mark 

$C0 


232 output 

Keyboa rd 

MIDI 

($9DE) 

$942 

$A00 

$7D0 

$8D0 

$950 

$100 

$80 

$80 

0 

0 

0 

0 

0 

0 

$40 

$20 

$20 

$C0 

$20 

$20 


Head and tail indices are naturally dependent on the current operating mode. 
High and low water marks are set at 3/4 and 1/4 of the buffer size. They 
have significance only for XON/XOFF or RTS/CTS in connection with 
RS-232. 
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15 rsconf set RS-232 configuration 

C: void rsconf (baud, Ctrl, ucr, rsr, tsr, scr) 
int baud, Ctrl, ucr, rsr, tsr, scr; 

Assembler: 

move.w scr,-(sp) 
move.w tsr,-(sp) 
move.w rsr,-(sp) 
move.w ucr,— (sp) 
move.w ctrl,-(sp) 
move.w baud, -(sp) 
move.w #15, -(sp) 
trap #14 
add.l #14, sp 

This XBIOS function serves to configure the RS-232 interface. The 
parameters have the following signifcance: 

scr: Synchronous Character Register in the MFP 

tsr: Transmitter Status Register in the MFP 

rsr: Receiver Status Register in the MFP 

ucr: USART Control Register in the MFP 

Ctrl: Communications parameters 
baud: Baud rate 

See the section on the MFP 68901 for information on the MFP registers. If 
one of the parameters is -1, the previous value is retained. The handshake 
mode can be selected with the Ctrl parameter: 

Ctrl Meaning 

0 No handshake, default after power-up 

1 XON/XOFF 

2 RTS/CTS 

3 XON/XOFF and RTS/CTS (not useful) 


174 



Abacas Software 


Atari ST Internals 


The baud parameter contains an indicator for the baud rate: 


baud Baud rate 


0 

19200 

1 

9600 

2 

4800 

3 

3600 

4 

2400 

5 

2000 

6 

1800 

7 

1200 

8 

600 

9 

300 

10 

200 

11 

150 

12 

134 

13 

110 

14 

75 

15 

50 

Example: 

move . w 

#-l / -(sp) 

move . w 

#-l,-(sp) 

move . w 

#-l,-(sp) 

move . w 

#-l,-(sp) 

move . w 

#l,-(sp) 

move . w 

#9, - (sp) 

move . w 

#15,-<sp) 

trap 

#14 

add.l 

#14, sp 


Don't change MFP registers 


XON/XOFF 
300 baud 
rsconf 
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16 keytbl set keyboard, table 

C: long keytbl (unshift, shift, capslock) 
long unshift, shift, capslock; 

Assembler: 


move.l capslock, - (sp) 
move . 1 shift , - ( sp) 
move.l unshift, - (sp) 
move.w #16,- (sp) 
trap #14 
addi .1 # 1 4 , sp 

With this function it is possible to create a new keyboard layout. To do this 
you must pass the address of the new tables which contain the key codes for 
normal keys (without shift), shifted keys, and keys with caps lock. The 
function returns the address of the vector table in which the three keyboard 
table pointers are located. If a table should remain unchanged, -1 must be 
passed as the address. A keyboard table must be 128 bytes long. It is 
addressed via the key scan code and returns the ASCII code of the given 
key. 

Example: 


move.l #-l,-(sp) Don't change caps lock 

move.l #shift,-(sp) Shift table 

move.l #unshift,- (sp) Table without shift 

move.w #16, -(sp) 

trap #14 

addi.l #14, sp 


shift : 

unshift : . . . 
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17 random 


return random number 


C: long random () 


Assembler: 


roove.w #17,-{sp) 
trap #14 
addq.l #2,sp 


This function returns a 24-bit random number. Bits 24-31 are zero. With 
each call you receive a different result. After turning on the computer a 
different seed is created. 


Example: 

move . w #17, -(sp) random 

trap #14 
addq.l #2,sp 
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18 protobt produce boot sector 

C: void protobt (buffer, serialno, disktype, execflag) 
long buffer, serialno; 
int disktype, execflag; 

Assembler: 

move.w execflag, - (sp) 
move.w disktype, - (sp) 
move . 1 serialno, - (sp) 
move.l buffer, -(sp) 
move . w # 1 8 , - ( sp ) 
trap #14 
add.l #14, sp 

This function serves to create a boot sector. A boot setor is located on track 
0, sector 1 on side 0 of a diskette and gives the DOS information about the 
disk type. If the boot sector is executable, it can be be used to load the 
operating system. With this function you can create a new boot sector, for a 
different disk format or to change an existing boot sector. The parameters: 

execflag: determines if the boot sector is executable. 

0 not executable 

1 executable 

-1 boot sector remains as it was 
The disk type can assume the following values: 

0 40 track, single sided (180 K) 

1 40 track, double sided (360 K) 

2 80 track, single sided (360 K) 

3 80 track, double sided (720 K) 

-1 Disk type remains unchanged 

The parameter serialno is a 24-bit serial number which is written in the 
boot sector. If the serial number is greater than 24 bits ($01000000), a 
random serial number is created (with the above function). A value of - 1 
means that the serial number will not be changed. 

The parameter buffer is the address of a 512-byte buffer which contains 
the boot sector or in which the boot sector will be created. 
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A boot sector has the following construction: 

Address 40 track SS 40 track DS 80 track SS 80 track DS 

0- 1 Branch instruction to boot program if executable 
2- 7 ’Loader' 


8-10 

24-bit 

serial 

number 



11-12 

BPS 

512 

512 

512 

512 

13 

SPC 

1 

2 

2 

2 

14-15 

RES 

1 

1 

1 

1 

16 

FAT 

2 

2 

2 

2 

17-18 

DIR 

64 

112 

112 

112 

19-20 

SEC 

360 

720 

720 

1440 

21 

MEDIA 

252 

253 

248 

249 

22-23 

SPF 

2 

2 

5 

5 

24-25 

SPT 

9 

9 

9 

9 

26-27 

SIDE 

1 

2 

1 

2 

28-29 

510-511 

HID 0 

CHECKSUM 

0 

0 

0 


The abbreviations have the following meanings: 


eps : Bytes per sector. The sector size is 5 1 2 bytes for all formats 

spc : Sectors per cluster. The number of sectors which are combined 

into one block by the DOS, 2 sectors equals IK. 

res : Number of reserved sectors at the start of the disk including the 

boot sector. 

fat : The number of file allocation tables on the disk. 

dir : The maximum number of directory entries. 

sec : The total number of sectors on the disk. 

media: Media descriptor byte, not used by the ST-BIOS. 
spf : Number of sectors in each FAT. 

spt : Number of sectors per track. 


179 




Abacus Software 


Atari ST Internals 


side : Number of sides of the diskette. 


hid : Number of hidden sectors on the disk. 

The boot sector is compatible with MS-DOS 2.x. This is why all 16-bit 
words are stored in 8086 format (first low byte, then high byte). 

If the checksum of the whole boot sector is $1234, the sector is executable. 
In this case the boot program is located at address 30. Example: 


move.w #-l,-(sp) 
move.w #3,-(sp) 
move.l #-l,-(sp) 
move.l #buf fer, - (sp) 
move.w #18,- (sp) 
trap #14 
add .1 # 1 4 , sp 


Don't change executability 
80 tracks DS 

Don’t change serial number 
protobt 


buffer ds.b 512 

This example program can be used to adapt an existing boot sector for 80 
tracks, double sided. 
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19 flopver verify diskette sector 

C: int flopver (buffer, filler, dev, sector, track, side, 
count) 

long buffer, filler; 

int dev, sector, track, side, count; 


Assembler: 


move.w count,- (sp) 
move.w side,— (sp) 
move.w track, -(sp) 
move.w sector, -(sp) 
move.w dev,-(sp) 
clr.l -(sp) 
move.l buffer, -(sp) 
move.w #19, -(sp) 
trap #14 
add .1 # 1 6 , sp 


This function serves to verify one or more sectors on the disk. The sectors 
are read from the disk and compared with the buffer contents in memory. 
The parameters have the same meaning as for reading and writing sectors. If 
the sector and buffer contents agree, the result of the function will be zero. 
If an error occurs, the error number will be returned in DO that has the 
following meaning: 


0 OK, no error 
-1 General error 
-2 Drive not ready 
-3 Unknown command 
-4 CRC error 

-5 Bad request, invalid command 
-6 Seek error, track not found 
-1 Unknown media (invalid boot sector) 
-8 Sector not found 
-9 (No paper) 

-10 Write error 

—11 Read error 

—12 General error 

-13 Diskette write protected 

-14 Diskette was changed 

-15 Unknown device 
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-16 Bad sector (during verify) 

-17 Insert diskette (for connected drive) 

In the case of an error, the buffer will contain a list of erroneous sectors 
(16-bit values), terminated by a zero word. If the BIOS function 4 rwabs 
was used to write the sectors and if the variable fverify ($444) is set, the 
sectors will automatically be verified after they are written. 

Example: 


move.w #l,-(sp) A sector 

move.w #0,-(sp) Side zero 

move.w #39, — (sp) Track 39 

move.w #l,-(sp) Sector 1 

move.w #0,~(sp) Drive A 

clr.l -(sp) 

move.l #buf fer, - (sp) Buffer address 

move.w #19, -(sp) flopver 

trap #14 

add. 1 #16, sp 

tst dO Error? 

bmi error 


182 




Abacus Software 


Atari ST Internals 


I 


20 scrdmp output screen dump 

C: void scrdmp () 

Assembler 


move.w #20, -(sp) 
trap #14 
addq .1 #2 , sp 

This function outputs a hardcopy of the screen to a connected printer. The 
previously-set printer parameters ("desktop Printer setup") are used. You 
can also perform this function by simultaneously pressing the ALT and 
HELP keys or from the desktop through "Print Screen" from the "Options" 
menu. 

Example: 


move . w #2 0 , - ( sp) Hardcopy 

trap #14 Call XBIOS 

addq.l #2,sp 
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21 cursconf set cursor configuration 

C: int cursconf (function, rate) 
int function, rate; 

Assembler: 


move.w rate,-(sp) 
move . w function, - (sp) 
move.w #21, -(sp) 
trap #14 
addq .1 # 6 , sp 


This XBIOS function serves to set the cursor function. The parameter 
function can have a value from 0-5, which have the following meanings: 


function 

0 

1 

2 

3 

4 

5 


Meaning 
Disable cursor 
Enable cursor 
Flash cursor 
Steady cursor 
Set cursor flash rate 
Get cursor flash rate 


You can use this function to set whether the cursor is visible, and whether it 
is flashing or steady. Thie XBIOS function returns a result only if you fetch 
the old baud rate. The unit of the flash frequency is dependent on the screen 
frequency: It is 70 Hz for a monochrome monitor or 50 Hz for a color 
monitor. You can set a new flash rate with function number 5. You need 
only use the parameter rate if you want to pass a new flash rate. 

Example: 


move.w #20, -(sp) 
move.w #4 , — (sp) 
move.w #21, -(sp) 
trap #14 
addq.l #6,sp 


20/70 seconds 
Set flash rate 
cursconf 
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22 settime 


set clock time and date 


C: void settime (time) 
long time? 

Assembler: 


move.l time,-(sp) 
move.w #22,- (sp) 
trap #14 
add.l #6,sp 


This function is used to set the clock time and date. The time is passed in the 
lower word of time and the date in the upper word. The time and date are 
coded as follows: 


bits 0- 4 
bits 5-10 
bits 11-15 


Seconds in two-second increments 

Minutes 

Hours 


bits 16-20 Day 1-31 

bits 21-24 Month 1-12 

bits 25-31 Year (minus offset 1980) 

Example: 


move.l #%1011001100000100000000000000,-(sp) 
move.w #22,- (sp) settime 

trap #14 
addq.l #6,sp 

This call sets the date to the 16th of September, 1985, and the clock time to 
8 o’clock. 
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23 gettime return clock time and date 

C : long gett ime ( ) 

Assembler: 

move.w #23,- (sp) 
trap #14 
addq.l #2,sp 

This function returns the current date and the clock time in the following 
format: 

bits 0- 4 Seconds in two-second increments 
bits 5-10 Minutes 
bits 11-15 Hours 

bits 16-20 Day 1-31 

bits 21-24 Month 1-12 

bits 25-31 Year (minus offset 1980) 


Example: 

move.w #23,- (sp) gettime 

trap #14 
addq.l #2,sp 

move.l dO, time Save time and date 
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24 bioskeys 


restore keyboard table 


C: void bioskeys O 
Assembler: 


move.w #24, -(sp) 
trap #14 
addq .1 #2 , sp 

If you have selected a new keyboard layout with the XBIOS function 16, 
keytbl, this function will restore the standard BIOS keyboard layout. You 
can call this function, for example, before exiting a program of your own 
which changed the keyboard layout. 


Example: 

move.w #24,- (sp) 
trap #14 
addq.l #2,sp 


bioskeys 
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25 ikbdws intelligent keyboard send 

C: void ikbdws (number, pointer) 
int number; 
long pointer; 

Assembler: 


move.l pointer, - (sp) 
move.w number, - (sp) 
move.w #25, -(sp) 
trap #14 
addq.l #8,sp 


This XBIOS function serves to transmit commands to the keyboard 
processor (intelligent keyboard). The parameter pointer is the address of a 
string to be sent, number is the length of a string minus 1. 


Example: 

move.l #string,- (sp) Address of the string 

move.w #strend~st ring-1,- (sp) Length minus 1 

move.w #25, -(sp) ikbdws 

trap #14 

addq.l #8, sp 

string dc.b $80,1 

strend equ * 
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26 jdisint disable interrupts on MFP 

C: void jdisint (number) 
int number ; 

Assembler. 


move.w number, -(sp) 
raove.w #26,— (sp) 
trap #14 
addq.l #4,sp 


This function makes it possible to selectively disable interrupts on the MFP 
6890 1. The parameter is the MFP interrupt number (0-15). The significance 
of the individual interrupts is described in the section on interrupts. 


Example: 

move.w #10, -(sp) Disable RS-232 transmitter interrupt 

move.w #26, -(sp) Disable interrupt 

trap #14 
addq.l #4,sp 
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27 jenabint enable interrupts on MFP 

C: void jenabint (number) 
int number; 

Assembler: 

move.w number, -(sp) 
move.w #27, -(sp) 
trap #14 
addq .1 # 4 , sp 

This function can be used to re-enable an interrupt on the MFP. The 
parameter is again the number of the interrupt, 0-15. 

Example: 

move.w #12, -(sp) Enable RS-232 receiver interrupt 

move.w #27, -(sp) Enable interrupt 

trap #14 
addq.l #4,sp 
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28 giaccess access GI sound chip 

C: char giaccess (data, register) 
char data; 
int register; 

Assembler: 

move.w #register, - (sp) 
move.w #data,-(sp) 
move.w #28, -(sp) 
trap #14 
addq .1 # 6 , sp 

This function allows access to the registers of the GI sound chip, 
register must contain the register number of the sound chip (0-15). The 
meaning of the individual registers is given in the hardware description of 
the sound chip. Bit 7 of the register number determines whether the 
specified register will be written or read: 

Bit 7 0: Read 

1 : Write 

When writing, an 8-bit value is passed in data; when reading, the function 
returns the contents of the corresponding register. 

Example: 

move.w #$80+3, -(sp) Write register 3 

move.w #$50, -(sp) Value to write 

move.w #28, -(sp) 
trap #14 
addq.l #6,sp 
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29 offgibit reset Port A GI sound chip 

C: void of fgibit (bitnumber) 
int bitnumber ; 

Assembler: 


move.w #bitnumber, - (sp) 
move.w #29, -(sp) 
trap #14 
addq.l #4,sp 


A bit of port A of the sound chip can be selectively set with this function 
call. Port A is an 8-bit output port in which the individual bits have the 
following funtion: 


Bit 0 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bit 6 
Bit 7 

Example: 


move . w 
move . w 
trap 
addq.l 


Select disk side O/side 1 

Select drive A 

Select drive B 

RS-232 RTS (Request To Send) 

RS-232 DTR (Data Terminal Ready) 

Centronics strobe 

General Purpose Output 

unused 


#4, - (sp) DTR bit 

#29, -(sp) offgibit 

#14 
#4, sp 
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30 ongibit clear Port A of Gl sound chip 

C : void ongibit (bitnumber) 
int bitnumber; 

Assembler: 

move.w #bitnumber,- (sp) 
move.w #30,— (sp) 
t rap #14 

addq.l #4,sp 

This function is the counterpart of the previous function. With this it is 
possible to clear a bit of port A in the sound chip. 

Example: 

move.w #4, - (sp) DTR bit 

move.w #30,- (sp) ongibit 

trap #14 
addq.l #4,sp 
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31 xbtimer startMFPtimer 


C: void xbtimer (timer, control, data, vector) 
int timer, control, data; 
long vector; 

Assembler: 


move.l vector, -(sp) 
move.w data,— (sp) 
move.w control, - (sp) 
move.w timer, -(sp) 
move.w #31,— (sp) 
trap #14 
add. 1 #12, sp 

This function allows you to start a timer in the MFP 68901 and assign an 
interrupt routine to it. timer is the number of the timer in the MFP: 


Timer A : 0 
Timer B : 1 
Timer C : 2 
Timer D : 3 


The parameters data and control are the values which are placed in the 
corresponding control and data registers of the timer. We refer you to the 
hardware description of the MFP 68901. 

The parameter vector is the address of the interrupt routine which will be 
executed when the timer runs out. The four timers in the MFP are already 
partly used by the operating system: 


Timer A 
Timer B 
Timer C 
Timer D 


Reserved for the end user 
Horizontal blank counter 
200 Hz system timer 
RS-232 baud rate generator 
(the interrupt vector is free) 
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Example: 

move . 1 #vector,-(sp) Interrupt routine 

move.w data,-(sp) Data and 

move.w control, - (sp) Control registers 

move.w #0, - (sp) Timer A 

move.w #31, -(sp) xbtimer 

trap #14 

add.l #12, sp 
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32 dosound set sound. parameters 

C: void dosound (pointer) 
long pointer; 


Assembler: 


move.l pointer, - (sp) 
move.w #32, -(sp) 
trap #14 
addq.l #6,sp 


This function allows for easy sound processing. The parameter pointer 
must point to a string of sound commands. The following commands can be 
used: 

Commands: $00-$0F 

These commands are interpreted as register numbers of the sound 
chip. A byte following this is loaded into the corresponding register. 

Command $80 

An argument follows this command which will be loaded into a 
temporary register. 

Command $81 

Three arguments must follow this command. The first argument is the 
number of the register in the sound chip in which the contents of the 
temporary register will be loaded. The second argument is a 
twoVcomplement value which will be added to the temporary 
register. The third argument contains an end criterium. The end is 
reached when the content of the temporary register is equal to the end 
criterium. 

Commands $82-$FF 

One argument follows each of these commands. If this argument is 
zero, the sound processing is halted. Otherwise this argument 
specifies the number of timer ticks (20ms, 50Hz) until the next sound 
processing. 
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Example: 

Pointer to sound coinmand 
dosound 


pointer dc.b 0,10,1,50,... 


move.l #pointer,-(sp) 
move.w #32, -(sp) 
trap #14 
addq.l #6,sp 
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33 setprt set printer configuration 

C: void setptr (config) 
int config; 

Assembler: 


move.w config, -(sp) 
move.w #33,- (sp) 
trap #14 
addq.l #4,sp 


This function allows the printer configuration to be read or changed. If 
config contains the value -1, the current value is returned, otherwise the 
value is accepted as the new printer configuration. The printer configuration 
is a bit vector with the following meaning: 


Bit number 0 1 

0 matrix printer daisy-wheel 

1 monochrome printer color printer 

2 Atari printer Epson printer 

3 Test mode Quality mode 

4 Centronics port RS-232 port 

5 Continuous paper Single-sheet 

6-14 reserved 

15 always 0 


Example: 


move.w #%000100,-(sp) Epson printer 

move.w #33, -(sp) setprt 

trap #14 
addq.l #4,sp 
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34 kbdvbase return keyboard vector table 

C : long kbdvbase ( ) 

Assembler: 


move . w #34, -(sp) 
trap #14 
addq.l #2,sp 


This XBIOS function returns a pointer to a vector table which contains the 
address of routines which process the data from the keyboard processor. 
The table is constructed as follows: 


long 

midivec 

MIDI input 

long 

vkbderr 

Keyboard error 

long 

vmiderr 

MIDI error 

long 

statvec 

IKBD status 

long 

mousevec 

Mouse routines 

long 

clockvec 

Clock time routine 

long 

joyvec 

Joystick routines 


The parameter midivec points to a routine which writes data received from 
the MIDI input (byte in DO) to the MIDI buffer. 

The parameters vkbderr and vmiderr are called when an overflow is 
signaled by the keyboard or MIDI ACLA. 

The remaining four routines statvec, mousevec, clockvec, and joyvec 
process the corresponding data packages which come from the keyboard 
ACIA. A pointer to the packaged received is passed to these routines in DO. 
The mouse vector is used by GEM. If you want to use your own routine, 
you must terminate it with RTS and it may not require more than one 
millisecond of processing time. 

Example: 

move.w #34, -(sp) kbdvbase 
trap #14 
addq.l #2,sp 
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We get $AOE as the result The vector field contains the following values: 


AOS 

midivec 

$79C6 

A12 

vkbderr 

$759C 

A16 

vmiderr 

$759C 

A1A 

statvec 

$7034 

A1E 

mousevec 

$15296 

A22 

clockvec 

$6A46 

A26 

joyvec 

$7034 

A2A 

MIDI 

$7556 

A2E 

keyboard 

$7568 
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35 kbrate set keyboard repeat rate 

C: int kbrate (delay, repeat) 
int delay, repeat; 

Assembler: 


move.w repeat, -(sp) 
move.* delay, -(sp) 
move.w #35, -(sp) 
trap #14 
addq.l #6,sp 


The keyboard repeat can be controlled with this function. The parameter 
delay specifies the delay time after a key is pressed before the key will 
automatically be repeated. The parameter repeat determines the time span 
after which the key will be repeated again. These values can be changed 
from the desktop by means of the two slide controllers on the control panel. 
The times are based on the 50 Hz system clock. If -1 is specified for one of 
the parameters, the corresponding value is not set. The function returns the 
previous values as the result; bits 0-7 contain the repeat value and bits 
8-15 the value of delay . 


Example: 

move.w #— 1 , — (sp) Read old values 

move.w #-l,-(sp) 

move.w #35, -(sp) kbrate 

trap #14 

addq.l #6,sp 

Result: DO = $0B03 
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36 prtblk output block to primer 

C: void prtblk (parameter) 
long parameter; 

Assembler: 


move . 1 parameter, - (sp) 
move.w #36, -(sp) 
trap #14 
addq .1 # 6 , sp 


This function resembles the function scrdmp (20) and is used by it. The 
function expects a parameter list, however, whose address is passed to it. 
This list is constructed as follows: 


long 

blkprt 

Address of the screen RAM 

int 

offset 


int 

width 

Screen width 

int 

height 

Screen height 

int 

left 


int 

right 


int 

scrres 

Screen resolution (0, 1, or 

int 

dstres 

Printer result ion (0 or 1) 

long 

colpal 

Address of the color palette 

int 

type 

Printer type (0-3) 

int 

port 

Printer port (0=Centronics, 

long 

masks 

Pointer to half-tone mask 

Assembler: 


move . 

1 #parameter,-(sp) Address of the pa 

move . 

w #36,- 

(sp) prtblk 

trap 

#14 


addq.l #6,sp 



1=RS232) 


parameter dc.l 
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37 wvbl 


wait for video 


C: void wvbl O 

Assembler: 


move.w #36, -(sp) 
trap #14 
addq.l #2,sp 


This function waits for the next picture return. It can be used to synchronize 
graphic outputs with the beam return, for example. 


Example: 

move.w #36,-(sp> wait for wvbl 

trap #14 
addq.l #2, sp 
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38 SUpexec set supervisor execution 

C: void supexec (address) 
long address; 

Assembler: 


mo ve . 1 addr es s , - ( sp ) 
move.w #38, -(sp) 
trap #14 
addq.l #6,sp 


If a routine is to be executed in the supervisor mode of the 68000 processor, 
you can accomplish this with this function. Simply pass the address of the 
routine to the function. Example: 


move.l #address, - (sp) 
move.w #38, - (sp) 
trap #14 
addq.l #6,sp 

address move.l $400,00 
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39 puntaes (Usable AES 

C: void puntaes () 

Assembler: 


move.w #39, -(sp) 
trap #14 
addq.l #2,sp 


The AES can be disabled with this function, provided it is not in ROM. 


Example: 

move.w #39, -(sp) 
trap #14 
addq .1 #2 , sp 
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3.4 The Graphics 


Next to the high processing speed and the large memory available, the 
graphics capability is certainly the most fascinating aspect of the ST. With 
die standard monochrome monitor and the resolution of 640x400 points, it 
creates a whole new price/performance class for itself. But also in the color 
resoultion the ST can display 16 colors with 320x200 screen points. 

In this chapter we want to explain how the graphics are organized and how 
you can create fast and effective graphics without using the GEM graphics 
package, which is rather complicated for beginners. The ST offers the 
programmer (assembler and C) very useful routines, with whose help 
graphics programming isn't quite child's play, but they can take away a 
good deal of the programming work. Unfortunately, some of these 
functions are so comprehensive that a detailed description would exceed the 
scope of this book. We have therefore had to limit ourselves to the simpler, 
but no less interesting functions. 

These graphics routines are called in a very elegant manner. The software 
developers have made use of the fact that there are two groups of opcodes in 
the 68000 which the 68000 does not "understand" and which generate a 
trap, or software interrupt, when they are encountered in a program. These 
are the two groups of opcodes which begin with $Axxx and $Fxxx. In the 
ST, the $Axxx opcode trap is used in order to access the graphics routines. 
The trap handler, the program called by the trap, checks the lowest byte of 
the "command" to see what value it has. Values between zero and $E are 
permissable here. This gives a total of 14 graphics routines, which should 
first be presented in an overview. Later we will talk about the actual 
commands in detail. 

$A000 Determine address of required variable range 

$A001 Set point on the screen 

$A002 Determine color of a screen point 

$A003 Draw a line on the screen 

$A004 Draw a horizontal line (very fast!) 

$A005 Fill rectangle with color 
$A006 Fill polygon line by line 
$A007 Bit block transfer 
$A008 Text block transfer 
$A009 Enable mouse cursor 
$A00A Disable mouse cursor 
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$A00B Change mouse cursor form 
$AOOC Clear sprite 
$AQ0D Enable sprite 
$A00E Copy raster form 

These routines are the ground work for the hardware-dependent part of 
GEM. All GEM graphic and text output is performed by the routines of the 
$Axxx opcodes. The set of A-opcodes are very useful in games. In games 
windows are needed only in the rarest cases. Another important point is the 
speed of the A-instructions. Using the graphic routines directly is clearly 
faster than if the output is handled by GEM. Before we describe the 
individual commands in detail, we will take a brief look at the construction 
of graphics in the various graphic modes of the ST. 

Immediately after turning the ST on, an area of 32K bytes is initialized at the 
upper memory border as the video RAM. In normal operation this results in 
addresses $78000 to $7FFFF acting as the screen RAM. This video RAM 
can be viewed as a window in the ST. We will start with the simplest mode, 
the 640x400 mode. In this case each 80 bytes, or better, each 40 words 
forms one screen line. The word with the lowest address is displayed on the 
left edge of the screen, the additional words are displayed in order from left 
to right. Within a word, the highest-order bit lies at the left and the 
lowest-order bit at the right 

With this data, any point on the screen can be easily controlled or read. For 
example, to set the first screen point, the value $8000 must be written into 
memory location $78000. Therefore you might store $8000 into memory 
location $78000. But this isn’t recommended. 

You might recall that the screen RAM in the ST can be moved quite easily. 
Then the absolute address of $78000 is no longer correct, of course. For 
this reason, it is usually more advantageous to set the the point with the ” A” 
function $A001. Function $A001 assumes an X-Y coordinate system with 
origin in tire upper left-hand comer, and determines the position of the video 
RAM itself in order to set the point at the proper screen location. 

In this resolution mode, each screen point is represented by a bit. If the bit 
is set, the point appears dark, or bright if the the inverse display mode is 
selected in color palette register 0. The screen consists of only one bit plane. 
Different colors cannot be represented with just one plane, however. This is 
why when the resolution increases in the color modes, the number of 
displayable colors decreases. 
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Figure 3.4-1 LO-RES-MODE (0) 

0 1 319 



VIDEO-RAM 
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Four colors possible in the 640x200 resolution mode. In this mode, two 
contiguous memory words form a single logical entity. The color of a point 
is determined by the value of the two corresponding bits in the two words. 
If both bits are zero, the background color results. Therefore two sequential 
words are used together for pixel representation. For the colors, however, 
all odd words belong to a plane. The second plane is made up of the even 
words. In this mode, there are two planes available. 

Things become quite colorful in the mode with "only” 320x200 points. In 
this operating mode, 4 contiguous memory words form one entity which 
detemines the color of the 16 pixels. To stick to the example we used 
before: in order to set the point in the upper left-hand comer, the topmost 
bits of words $78000, $78002, $78004, and $78006 must be manipulated. 
The desired color results from the bit pattern in the words. It naturally 
requires some computer time to set a point in the desired color, independent 
of the mode. All of this work is handled by the $A001 routine, however. 
This routine sets all of the pertaining bits for the desired color in the current 
resolution. Naturally, all four planes are present in this mode. The first 
plane, keeping to our example, made up of the words at address $7F000, 
$7F008, $7F010, ..., and the other planes are composed of the other 
addresses correspondingly. 

Another point to be clarified concerns the fonts or character sets. Since the 
ST does not have a text mode, only a graphics mode, the text output is 
created in high-resolution graphics. There are three different fonts built into 
the ST. You can load additional fonts from disk. Each font has a header 
which contains important information about the displayable characters. 
Since the important data are contained in the font header, there are unusually 
few limits for display. The characters can be arbitrarily high or wide. The 
age of the 8x8 matrix for character output is over. Genuine proportional 
type on the screen (!) is even possible. 

The three built-in fonts use relatively few of the many possibilities which 
GEM allows for character generation. All three fonts are mono-spaced 
fonts, meaning they have a fixed defined size in pixels and a defined pitch. 
The smallest font has a matrix of 6x6. With a resolution of 640x400 points, 
66 lines of 106 characters each can be displayed. This font is only 
accessible for output under GEM, not for output under TOS, and is used in 
the output of the directory in the icon form, for example. The next-largest 
type is composed of 8x8 points. This type is used when a color monitor is 
connected to the ST, while the third and largest font is used for the normal 
black-and-white mode. This font uses a matrix of 8x16 points. 
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The exact layout of the font header is found under command $A008, which 
represents a very versatile text output which goes far beyond what is 
possible with the routine of the BIOS and GEMDOS. 

Finally, we must clarify some of the terms which will come up often in the 
following descriptions, whose meaning may not be so clear. These are the 
terms CONTRL array, INTIN array, INTOUT array, PTSIN array and 
PTSOUT array. These arrays are mainly used by GEM to pass parameters 
to individual GEM functions or to store results from these functions. But 
line-A functions use parts of these arrays to pass parameters also. The 
arrays are defined in memory as data areas, whereby each element in the 
array consists of 2 bytes. 

For GEM functions, the CONTRL array always contains the number 
desired in the first element (CONTRL(0)). This parameter is not used by the 
line-A commands, however. CONTRL(l) contains the number of XY 
coordinates required for the function. These coordinates must be placed in 
the PTSIN array before the call. The element CONTRL(2) is not supplied 
before the call. After the call it contains the number of XY coordinates in the 
PTSOUT array. CONTRL(3) specifies how many parameters will be 
passed to the function in the EMTIN array, while CONTRL(4) contains the 
number of parameters in the INTOUT array after the call. The additional 
parameters of the CONTRL array are not relevant for users of the line A. 

Unfortunately, not all of the parameters for the A opcodes can be in these 
arrays. For this reason there is another memory area which used as a 
variable area for (almost) all graphic outputs. The function and use of these 
over 50 variables is found in a table at the end of this chapter. Important 
variables are also explained in conjunction with the functions which require 
them. 

By the way, you should be aware that registers DO to D2 and AO to A2 are 
changed by calling the functions. Important values contained in these 
registers should be saved before a call. 
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Figure 3.4-3 HI-RES-MODE (2) 


0 12 • • 639 



212 


Abacus Software 


Atari ST Internals 


$A000 Initialize 

Initialize is really the wrong expression for this function. After the call, the 
addresses of the more important data areas are returned in registers DO and 
AO to A2. This function does not require input parameters. 

The program is informed of the starting address of the line-A variables in 
DO and AO. After the call, A1 points to a table with three addresses. These 
three addresses are the starting address of the three system font headers. 
Register A2 points to a table with the starting addresses of the 15 line-A 
routines. 

This opcode destroys (at least) the contents of registers DO to D2 and AO to 
A2. Important values should be saved before the call. 


$A001 PUT PIXEL 

This opcode sets a point at the coordinates specified by the coordinates in 
ptsin (0) and ptsin ( l) . The color is passed in intin (0) . ptsin(O) 
contains X-coordinate, ptsin ( 1 ) the Y-coordinate. 

The coordinate system used has its origin in the upper left comer. The 
possible range of the X and Y coordinates is naturally set according to the 
graphic mode enabled. Overflows in the X range are not handled as errors. 
Instead, the Y coordinate is simply incremented by the appropriate amount. 
No output is made if the Y range is exceeded. 

The color in intin (0) is dependent on the mode used. When driving the 
monochrome monitor, only bit zero of the value of intin (0) is evaluated. 


$A002 GET PIXEL 

The color of a pixel can be determined with this opcode. As with $A001, 
the XY coordinates are passed in ptsin (0) and ptsin (l) ; the color value 
is returned in the DO register. 
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$A003 LINE 

With the LINE opcode a line can be drawn bewteen the points with 
coordinates xl,yl and x2,y2. The parameters for this function are not 
passed via the parameter arrays, but must be transferred to the line-A 
variables before the call. The variables used are: 


_X1 

= xl 

coordinate 

_Y1 

= yi 

coordinate 

_X2 

= x2 

coordinate 

_Y2 

= yl 

coordinate 


_FG_BP_1 = Plane 1 (all three modes) 

_FG_BP_2 = Plane 2 (640x200, 320x200) 

_FG_BP_3 = Plane 3 (only 320x200) 

_FG_BP 4 = Plane 4 (only 320x200) 

LN_MASK = Bit pattern of the line 

For example: $FFFF = filled 
$CCCC = broken 

_WRT__MOD = Determines the write mode 

_LSTLIN = This variable should be set to -1 ( $FFFF) 

One point to be noted for some applications is the fact that when drawing a 
line, the highest bit of the line bit pattern is always set on the left screen 
edge. The line is always drawn from left to right and from top to bottom, 
not from xl,yl to x2,y2. 

Range overflows are handled as for PUT PIXEL. If an attempt is made to 
draw a line from 0,0 to 650,50, a line is actually drawn from, 0,0 to 
639,48. The "remainder” results in an additional line from 0,49 to 10,50. 

A total of four different write modes, with values 0 to 3, are available for 
drawing lines. With write mode zero, the original bit pattern "under” the line 
is erased and the bit pattern determined by _ln_mask is put in its place 
(replace mode). In the transparent mode (_wrt _mod=i), the background, the 
old bit pattern, is ORed with the new line pattern so only additional points 
are set. In the XOR mode (_wrt_mod= 2 ), the background and the line 
pattern are exclusive-ored. The last mode (_wrt_mod=3) is the so-called 
"inverse transparent mode." As in the transparent mode, it involves an OR 
combination of the foreground and background data, in which the 
foreground data, the bit pattern determined by _ln_mask, are inverted 
before the OR operation. 
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$A004 HORIZONTAL LINE 

This function draws a line from xl,yl to x2,yl. Drawing a horizontal line is 
significantly faster than when a line must be drawn diagonally. Diagonal 
lines are also created with this function, in which the line is divided into 
multiple horizontal lines segments. The parameters are entered directly into 
the required variables. 


xi 

Y1 

X2 

FG_BP_1 = 
FG_BP_2 = 
FG_BP_3 = 
FG_BP_4 = 
WRT MOD = 


xl coordinate 
yl coordinate 
x2 coordinate 
Plane 1 (all three modes) 
Plane 2 (640x200, 320x200) 
Plane 3 (only 320x200) 
Plane 4 (only 320x200) 
Determines the write mode 


_patptr = Pointer to the line pattern to 
_patmsk = "Mask" for the line pattern 


use 


The valid values in _wrt_mod also lie between 0 and 3 for this call. The 
contents of the variable _patptr is the address at which the desired line 
pattern or fill pattern is located. The H-line function is very well-suited to 
creating filled surfaces. The variable _patmsk plays an important role in 
this. The number of 16-bit values at the address in _patptr is dependent 
on the its value. If, for example, _patmsk contains the value 5, six 16-bit 
values should be located at the address in _patptr as the line pattern. If a 
horizontal line with the Y-coordinate value zero is to be drawn, the first bit 
pattern is taken as the line pattern. The second word is taken as the pattern 
for a line drawn at Y-coordinate 1, and so on. The pattern for a line with 
Y-coordinate 6 is again determined by the first value in the bit table. In this 
manner, very complex fill patterns can be created with relatively little effort 
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$A0O5 FILLED RECTANGLE 

The opcode $A005 represents an extension, or more exactly a special use, 
of opcode $A004. It is used to created filled rectangles. The essential 
parameters are the coordinates of the upper left and lower right comers of 
the of the rectangle. 


_X1 = xl coordinate, left upper 

_Y1 = yl coordinate 

_X2 = x2 coordinate, right lower 

_Y2 = y2 coordinate 

_FG_BP_1 = Plane 1 {all three modes) 

_FG_BP_2 = Plane 2 (640x200, 320x200) 

J?G_BP_3 = Plane 3 (only 320x200) 

_FG_BP_3 = Plane 4 (only 320x200) 

WRT_MOD = Determines the write mode 
_patptr = Pointer to the fill pattern used 
_patmsk = "Mask" for the fill pattern 

_CLIP = Clipping flag 

XMN_CLIP = X minimum for clipping 
XMX_CLIP = X maximum for clipping 
YMN CLIP = Y minimum for clipping 


YMX CLIP = Y maximum for clipping 


We have already explained all of the variables except the "clipping" 
variables. What is clipping? Clipping creates extracts or clippings of the 
total picture. If the clipping flag is set to one (or any value not equal to 
zero), the rectangle, drawn by $A005, is displayed only in the area defined 
by the clipping-area variables. An example may explain this behavior better: 
The values 100,100 and 200,200 are specified as the coordinates. The clip 
flag is 1 and the clip variables contain die values 150,150 for xmn clip and 
ymn clip as well as 300,300 for xmx_clip and ymx_clip. The value 
$FFFF will be chosen as the fill value for all of the lines. With these values, 
the rectangle will have the coordinate 150,150 as the upper left comer and 
200,200 as the lower right. The "missing” area is not drawn because of the 
clip specifications. Clearing the clip flag draws the rectangle in the originally 
desired size. 
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$A006 FILLED POLYGON 


$A006 is also an extension of $A004. Arbitrary surfaces can be filled with a 
pattern with this function. The entire surface is not filled with the call: just 
one raster line is filled, a horizontal line with a width of one point. The 
result is that there are significantly more options for influencing the fill 
pattern. 


The necessary variables are: 

PTSIN = Array with the XY coordinates 

CONTRL(l) = Number of coordinate pairs 
_Y1 = yl coordinate 

_FG_BP_1 = Plane 1 (all three modes) 
_FG_BP_2 = Plane 2 (640x200, 320x200) 
_FG_BP_3 = Plane 3 (only 320x200) 
_FG_BP_3 = Plane 4 (only 320x200) 

WRT MOD = Determines the write mode 


_patptr 
_patmsk 
_CLIP 
_XMN_CLIP 
_XMX_CLIP 
_YMN__CLIP 
YMX CLIP 


Pointer to the fill pattern used 
"Mask” for the fill pattern 
Clipping flag 
X minimum for clipping 
X maximum for clipping 

Y minimum for clipping 

Y maximum for clipping 


Basically, all of the parameters here are to be set exactly as they might be for 
a call to $A005. Only the first three coordinates are different The XY 
coordinates are stored in the ptsin array. It is important you specify the 
start coordinate again as the last coordinate as well. In order to fill a triangle, 
you must, for example, enter the coordinates (320,100), (120,300), 
(520,300), and (320,100). The number of effective coordinate pairs, three 
in our example, must be placed in contrl ( l) , the second element of the 
array. With a call to the $A006 function you must also specify the 
Y-coordinate of the line to be drawn. Naturally you can fill all Y-coordinates 
from 0 to 399 (0 to 199 in the color modes) in order. But it is faster to find 
the largest and smallest of the XY values and call the funtion with only these 
as the range. 
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$A007 BITBLT 

The bit block transfer is used by the text block transfer, $A008, and copy 
raster form, $A00E. Register A6 must contain a pointer to a parameter table. 
Unfortunately, the construction of this parameter table could not be 
determined definitively. Our attempts led to classic system crashes about 
70% of the time. For this reason, we cannot say much about the function. 


$A008 TEXTBLT 

A character from any desired text font can be printed at any graphic position 
with the TEXT BLock Transfer function. In addition, the form of the 
character can be changed. The character can be displayed in italics, 
boldface, outlines, enlarged, or rotated. These things cannot be achieved 
with the "normal" character outputs via the BIOS or GEMDOS. But to do 
this, a large number of parameters must be set and controlled. A rather 
complicated program must be written in order to output text with this 
function. If the additional options are not absolutely necessary, it is 
advisable not to use this function. But please decide for yourself. 

Before we produce a character on the screen, we must first concern 
ourselves with the organization of the fonts. We must take an especially 
close look at the font header because the font is describe in detail by the 
information contained in it 

Basically, a font consists of four sets of data: font header, font data, 
character offset table, and horizontal offset table. The font header contains 
general data about the font, such as its name and size, the number of 
characters it contains, and various other aspects. This information takes up a 
total of 88 bytes. The font data contains the bit pattern of the existing, 
displayable characters. These data are organized so as to save as much space 
as possible. 

In order to be able to better describe the organization, we will imagine a font 
with only two characters, such as "A" and "B". These characters are to be 
displayed in a 9x9 matrix. The font data are now in memory so that the bit 
pattern of the top scan line of the "A" is stored starting at a word boundary. 

Since our font is 9 pixels = 9 bits wide, one byte is completely used, but 
only the top bit of the following byte. 7 bits must be wasted if the top scan 
line of the "B" is also to begin on a word boundary. This is not so, 
however, and the first scan line of the "B" starts with bit 6 of the second 
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byte of the font data. Only the data of the second and further scan lines 
always start on a word boundary. In this manner, almost no bits are wasted 
in the font Only the start of the scan lines of die first character actually 
begin on a word boundary; all other scan lines can begin at any bit position. 

Because of this space-saving storage, the position of each character within 
the font must be calculated. The calculation of the scan-line positions is 
possible through the character offset table. This table contains one entry for 
each displayable character. For our example, such a table would contain the 
entries $0000, $0009, $0012. Through the direction of this table, it is 
possible to create true proportional type on the screen since the width of 
each character can be calculated. One subtracts the entry of the character to 
be displayed from the entry of the next character. The last entry is present so 
that the width of the last character can also be determined, although it is not 
assigned to a character. 

In addition to the character offset table there is the horizontal offset table. 
This table is not used by most of the fonts, however. The fonts present in 
the ST do not use all the possibilities of this table either. If this table were 
present, it would contain a positive or negative offset value for each 
character, in order to shift the character to the right or left during output 

At the end of the description of the font construction are the meanings of the 
variables in the font header. 


Bytes 

0- 1 

Bytes 

2- 3 

Bytes 

Bytes 

4-35 

36-37 

Bytes 

38-39 

Bytes 

40-49 

Bytes 

Bytes 

50-51 

52-53 


Bytes 54-55 


: Font identifier. A number which describes the 
font . l=system font 

: Font size in points (point is a measure used 
in type-setting) . 

: The name of the font as an ASCII string. 

: The lowest ASCII value of the displayable 
characters . 

: The highest ASCII value of the displayable 
characters . 

: Relative distances of top, ascent, half, 
descent, and bottom line from the base line. 

: Width of the broadest character in the font . 

: Width of the broadest character cell. The cell 
is always at least one pixel wider than the 
actual character so that two characters next 
to each other are separated from each other. 

: Linker offset. 
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Bytes 56-57 

Bytes 58-59 

Bytes 60-61 
Bytes 62-63 


Bytes 64-65 
Bytes 66-67 


Bytes 68-71 

Bytes 72-75 
Bytes 76-79 
Bytes 80-81 


Bytes 82-83 
Bytes 84-87 


: Right offset. The two offset values are only 
used for displaying the font in italics 
(skewing) . 

: Thickening. If a character is to be displayed 
in boldface, the value of this variable is 
used. 

: Underline. Contains the height of the 
underline in pixels. 

: Lightening mask. "Light" characters are found 
on the desktop when an option on a pull-down 
menu is not available. This light grey 
character consists of masking the bits with 
the lightening mask. Usually the value is 
$5555. 

: Skewing mask. As before, only for displaying 
characters in italics. 

:Flag. Bit 0 is set if the font is a system 
font. 

Bit 1 must be set if the horizontal offset 
table is present . 

Bit 2 is the so-called byte-swap flag. If it 
is set, the bytes in memory are in 68000 
format (low byte-high byte) . A cleared swap 
flag signals that the data is in INTEL format, 
reversed in memory. With this bit the fonts 
from the IBM version of GEM can be used on the 
ST and vice versa . 

Bit 3 is set if the width of all characters in 
the font is equal. 

: Pointer to the horizontal offset table or 
zero. 

: Pointer to the character offset table. 

: Pointer to the font data. 

: Form width. This variable contains the sum of 
widths of all the characters. The value 
represents the length of the scan lines of all 
of the characters and thereby the start of the 
next line. 

: Form height. This variable contains the number 
of scan lines for this font. 

: Contain a pointer to the next font . 
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After so much talk, we should now list the parameters which must be noted 
or prepared for the $A008 opcode. 


WRT_MODE 

TEXT_FG 

_TEXT_BG 

FBASE 

FWIDTH 

SOURCEX 

SOURCEY 

DESTX 

DESTY 

DELX 

DELY 

STYLE 

LITEMASK 

SKEWMASK 

WEIGHT 

_R_OFF 

~L_OFF 

SCALE 

~XACC_DDA 

_DDA_INC 

JTJSCLSTS 

"CHUP 

_MONO_STATUS 

_scrtchp 

_scrpt2 


Write mode 

Text foreground color 

Text background color 

Pointer to the start of the font data 

Width of the font 

X-coordinate of the char in the font 
Y-coordinate of the char in the font 
X-coordinate of the char on the screen 
Y-coordinate of the char on the screen 
Width of the character in pixels 
Height of the character in pixels 
Bit-wise coded flag for special effects 
Bit pattern used for "lightening” 

Bit pattern used for skewing 
Factor for character enlargement 
Right offset of the char for skewing 
Left offste of the char for skewing 
Flag for scaling 
Accumulator for scaling 
Scaling factor 
Scaling direction flag 
Character rotation vector 
Flag for monospaced type 
Pointer to buffer for effects 
Offset scaling buffer in _scrtchp 


The five clip variables are also evaluated. 

As you can see, an enormous number of variables are evaluated for the 
output of graphic text. Here we can go into only the essential (and those we 
explored) variables. 

The write mode allows the output of characters in the four known modes, 
replace, OR, XOR, and inverse OR. There are 16 other modes available 
whose effects are not yet known. The variable _text_fg is in connection 
with first four write modes. They form the foreground color used for 
display. The background color _text_bg plays a role only with the 16 
additional modes. It is clear that the additional modes are relevant only in 
connection with a color screen. 
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The variables _fbase and fwidth are set according to the desired font. 
You can find the start of the font data from the header of the desired font 
(bytes 76-79 in the header). _fwidth must be loaded with the contents of 
the bytes 80 and 81 of the header. 

The parameter _sourcex determines which character you output. It should 
contain the ASCII value of the desired character. 

The parameter _sourcey is usually zero because the character is to be 
generated from the top to the bottom scan line. 

The parameter _delx can be be calculated as the width of the character in 
which the entry in the character offset table of the desired character is 
subtracted from the next entry. The result is the width of the character in 
pixels, dely must be loaded with the value of byte 82-83 of the header. 

The style is something special. Here you can specify if characters should 
be displayed normally or changed. The possible changes are boldface 
(thicken, bit 0), shading (lighten, bit 1), italic (bit 2), and outline (bit 4). 
The given change is enabled by setting the corresponding bit. Another 
change is scaling. The size of a character can be changed through scaling. 
Unfortunately, characters can only be enlarged on the ST. 

If the scaling flag is cleared (zero), the character is displayed in its original 
size. The t sclsts flag determines if the font is to be reduced or 
enlarged. A value other than zero must be placed here for enlarging. 

dda tnc should contain the value of the enlargement or reduction. An 
enlargement could be produced only with a value of $FFFF. 

Another interesting variable is _chup. With the help of this variable, 
characters can be rotated on the screen. The angle must be given in the range 
0 to 360 degrees in tenths of a degree. A restriction must also be made for 
this function. Usuable results are obtainable only with rotations by 90 
degrees. The values are $0000 for normal, $0384 for 90-degree rotation, 
$0704 (upside-down type), and $0A8C for 270 degrees. 

To work with the effects, scrchp must contain a pointer to a buffer in 
which TEXTBLT can store temporary values. The exact size of this buffer 
is not known, but we always found a buffer of IK to be sufficient. Another 
buffer must be specified for enlargement (_scrtpt2). An offset is passed as 
a parameter which refers to the start of the scrtchp buffer. A value of $40 
proved to be sufficient here. 
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$A009 SHOW MOUSE 

Calling this opcode enables the display of the mouse cursor. The cursor 
follows the mouse when it is moved. If the mouse cursor is disabled, the 
mouse can be used in programs which abandon the user interface GEM. 
This option is particularly useful for games. 

The parameters required are passed in the intin and contrl arrays. 
contrl ( l ) should be cleared before the call and contrl (3 ) set to one. 
intin ( 0 ) has a special significance. The routine for managing the mouse 
cursor counts the number of calls to remove and enable the cursor. If the 
cursor is disabled twice, two calls must be made to re-enable it before it will 
actually appear on the screen. This behavior can be changed by clearing 
intin ( 0 ) . With this parameter the cursor is immediately set independent of 
the number of previous HIDE CURSOR calls. If the value in intin { 0 ) is 
not equal to zero the actually required number of $A009 calls must be made 
in order to make the cursor visible. 


$A00A HIDE CURSOR 

This functions hides the cursor. If this function is called repeatedly, the 
number is recorded by the operating system and determines the number of 
calls of SHOW CURSOR before the cursor actually appears. 


$A00B TRANSFORM MOUSE 

Is the arrow unsuited as a mouse cursor for games? Simply make your own 
cursor. How would it be if a little car moved across the screen instead of an 
arrow? The opcode $A00B gives your fantasy free reign, at least as far as it 
concerns the mouse cursor. 

The parameters must be passed in the intin array. A total of 34 words are 
necessary. The following table gives information about the use and possible 
values: 

INTIN (3) Mask color index, normally 0 
INTIN (4) Data color index, normally 1 

INTIN (5) to INTIN (20) contain 16 words of the cursor mask 
INTIN (21) to INTIN (36) contain 16 words of cursor data 
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The form of the cursor is determined by the cursor data. Each 1 in the data 
creates a point on the screen. If a cursor is placed over a letter or pattern on 
the screen, the border between the cursor and the background cannot be 
determined The mask enters at this point. Each set bit in the mask clears the 
background at the given location. This permits a light border to be drawn 
around the cursor. Take a look at the normal arrow cursor in order to see the 
operation of the mask. 


$A00C UNDRAW SPRITE 

This opcode is related to $AOOD, DRAW SPRITE. The ST actually has no 
hardware sprites in sense in which sprite is used on something like the 
Commodore 64. The ST sprites are organized purely in software. Each 
sprite is 16x16 pixels large. One example of an ST sprite is the mouse 
cursor. It is created with this function. 

In order to clear a previously-drawn sprite, the address of a buffer in which 
the background was saved when the sprite was drawn is passed in register 
A2. The opcode simply transfers the contents of the background buffer to 
the right spot on the screen. The buffer itself must be 64 bytes large for each 
plane. Another 10 bytes are used, independent of the number of planes. For 
monochrome display, the buffer is a total of 74 bytes long, while in the 
320x200 pixel resolution (for planes), it is 4x64+10=266 bytes large. 


$A00D DRAW SPRITE 

This function draws the desired sprite on the screen. Parameters must be 
passed in the DO, Dl, A0, and A2 registers. 

DO and Dl contain the X and Y-coordinates of the position of the sprite on 
the screen, called the hot spot. A0 is a pointer to the so-called sprite 
definition block and A2 contains the address of the sprite buffer in which 
the backgroud will be saved for erasing the sprite later. 

The sprite definition block must have the following construction: 

Word 1 : X offset to hot spot 

Word 2 : Y offset to hot spot 

Word 3 : Format flag 0=VDI format, l=XOR format 

Word 4 : Background color (bg) 

Word 5 : Foreground color (fg) 
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Following this are 32 words which contain the sprite pattern. The pattern 
must be in memory in the following order: 

Word 6 : Background pattern of the top line 

Word 7 : Foreground pattern of the top line 

Word 8 : Background pattern of the second line 

Word 9 : Foreground pattern of the second line 

etc. 

The information in the format flag has the following significance: 


VDI Format 
fg bg Result 

0 0 The background appears 

0 1 The color in word 4 appears 

1 0 The color in word 5 appears 

1 1 The color in word 5 appears 

XOR Format 
fg bg Result 

0 0 The background appears 

0 1 The color in word 4 appears 

1 0 The pixel on the screen is XORed with the fb 

bit 

1 1 The color in word 5 appears 

$A00E COPY RASTER FORM 

Arbitrary areas of the screen can be copied with the $A00E opcode. Not 
only areas within the screen, but also from the screen into free RAM, and 
even more important, from the RAM to the screen. Even complete screen 
pages can be copied very quickly with the COPY RASTER opcode. The 
name RASTER FORM does express one limitation of the function, 
however. Each raster form to be copied must begin on a word boundary and 
must be a set of words. 

The parameters are quite numerous and are passed in the contrl, ptsin, 
and intin arrays. In addition, two "memory fom definition" blocks must 
be in memory for COPY RASTER. We will start with the MFD blocks. 
Since a copy operation must always have a source and a destination, one 
block describes the source memory range and the second describes the 
destination. Each block consists of 10 words. The address of the memory 
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described by the block is contained in the first two words. The third word 
specifies the height of the form in pixels. Word 4 determines the width of 
the form in words. Word 6 should be set to 1 and word 7 specifies the 
number of planes of which the form is composed. The remaining words 
should be set to zero because they are reserved for future extensions. 


3.4*1 An overview of the "line-A” variables 

After the initialization $A000, DO and AO contain the address of a variable 
area which contains more than 50 line-A variables. The essential variables 
have been described along with the various calls, but not the location of the 
variables within the variable block. We will present this list shortly. When 
naming the variables we have remained with the names used in the official 
Atari documentation. 

Offset is the value which must be given to access the value register relative. 
Variables supplied with a question mark could not be definitively explained. 


fset 

Name 

Size 

Function 

0 

v_planes 

word 

Number of planes 

2 

v_lin_wr 

word 

Bytes per scan line 

4 

CONTRL 

long 

Pointer to the CONTRL array 

8 

INTIN 

long 

Pointer to the INTIN array 

12 

PTSIN 

long 

Pointer to the PTSIN array 

16 

INTOUT 

long 

Pointer to the INTOUT array 

20 

PTSOUT 

long 

Pointer to the PTSOUT array 

24 

_FG_BP_1 

word 

Plane 0 color value 

26 

_FG_BP_2 

word 

Plane 1 color value 

28 

_FG_BP_2 

word 

Plane 2 color value 

28 

_FG_BP_2 

word 

Plane 3 color value 

32 

_LSTLIN 

word 

Should be -1 <$FFFF) (?) 

34 

_LN_MASK 

word 

Line pattern for $A003 

36 

_WRT_MODE 

word 

Write mode (0=write mode 
l=transpa rent 
2=XOR mode 
3=Inverse trans 

38 

_X1 

word 

Xl-coordinate 

40 

Y1 

word 

Y1 -coordinate 

42 

_X2 

word 

X2-coordinate 

44 

Y2 

word 

Y2-coordinate 


226 



Abacus Software 


Atari ST Internals 


46 

_patpt r 

long 

Pointer to the fill pattern 
(see $A004) 

50 

_patmsk 

word 

Fill pattern "mask” 
(see $A004) 

52 

multifill 

word 

0 =fill pattern is only for 
one plane 

l=fill pattern is for multi- 
plane 

54 

_ CLIP 

word 

0=no clipping (see $A005) 
not 0=clipping 

56 

XMN_CLIP 

word 

and 

58 

_YMN_CLIP 

word 

define upper left corner of 
the visible area for clipping 

60 

_XMX_CLIP 

word 

and 

62 

_YMX_CLIP 

word 

define lower right corner of 
the visible area for clipping 

64 

_XACC_DDA 

word 

Should be set to $8000 before 
each call to TXTBLT (?) 

66 

_DDA_INC 

word 

Enlargement /reduction factor 
$FFFF for enlargement, 
reduction doesn't work (?) 

68 

_T_SCLSTS 

word 

0=reduction (?) 
l=enlargement 

70 

_MONO_STATUS word 

l=not proportional font 
0=proportional type or width 
of character changed by bold 
or italics 

72 

SOURCEX 

word 

X-coordinate of char in font 

74 

SOURCEY word Y-coord of char in font (0) 

Note: 

SOURCEX is the value of the character from the 
horizontal offset table (HOT) and can be 
calculated witht he following formula: 

SOURCEX = HOT-element (ASCII value minus FIRST 
ADE) 

The variable FIRST ADE is contained in bytes 
36/37 of the font header (see example) 

76 

_DESTX 

word 

X-position of char on screen 

78 

_DESTY 

word 

Y-position of char on screen 

80 

DELX 

word 

Width of the character 

82 

DELY 

word 

Height of the character 
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Note: 

DELX can be calculated with this formula : 

DELX = SOURCEX+1 minus SOURCEX 
(see $A008) 

DELY is the value FORM height from bytes 82,83 of 
the font header. 


84 

_FBASE 

long 

Pointer to start of font data 

88 

_FWIDTH 

long 

Width of font form 

90 

_STYLE 

word 

Flags for special effects 
(see $A008) 

92 

_LITEMASK 

word 

Mask for shading 

94 

_SKEWMASK 

word 

Mask for italic type 

96 

_WEIGHT 

word 

Number of bits by which the 
character will be expanded 

98 

_R_OFF 

word 

Offset for italic type 

100 

_L_OFF 

Note: 

word 

Offset for italic type 


The above five variables should be loaded with 
the corresponding values from the font header. 


102 

_SCALE 

word 

0=no scaling 

l=scaling (enlarge/ reduce) 

104 

_CHUP 

word 

Angle for character rotation 
0=normal char representation 
$384=rotated 90 degrees 
$708=rotated 180 degrees 
$A8C=rotated 270 degrees 

106 

_TEXT_FG 

word 

Foreground color for text 
display 

108 

_scrtchp 

long 

Address of buffer required 
for creating special text 
effects 

112 

_scrpt2 

word 

Offset of the enlargement 
buffer in the scrtchp buffer 

114 

_TEXT_BG 

word 

Background color for text rep 

116 

_COPYTRAN 

word 

(?) 
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3.4.2 Examples for using the line-A opcodes 


In order to ease your first experiments with the line-A opcodes, we have 
given a few examples which can serve as a starting-point for you. In the 
first example, a point is set on the screen with $A001, and then the color of 
the point is determined with $A002. 


****** a******************-************* ****************** 

* Demo of the SAOOO, $A001 and $A002 functions 

* 

* rbr 09/28/85 

,**,.****,**,««**,,*********■********•*******«****• ********* 


intin 

equ 

8 


ptsin 

equ 

12 


init 

equ 

SaOOO 


set pi x 

equ 

SaOOl 


getpix 

equ 

$a002 


start : 

.dc.w 

init 

* call SAOOO 


move . 1 

intin (aO) ,a3 

* address of INTIN-arrays 


move . 1 

ptsin (aO) , a4 

* address of PTSIN-arrays 


move 

#300, <a4) 

* X coordinate 


move 

#100, 2 (a4) 

* Y coordinate 


move 

#1, <a3) 

* color set, pixel set 

* 



0 erase pixel 


.dc.w 

setpix 

* pixel set 


move 

#300, (a4) 

* X coordinate 


move 

#100, 2 <a4) 

* y coordinate 


.dc.w getpix * get color value 


dO contains prersent color value 


Only color values zero and one make sense for a monochrome monitor. 
Other values can be entered when working in one of the color modes, 
however. 
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The next example shows how a triangle can be drawn on the screen with the 
function FILLED POLYGON. 


-A************************************************ 

* 

* 

* a006 - filled pologyn 

* 

* 

************************************************* 


contrl 

equ 

4 

ptsin 

equ 

12 

fgbpl 

equ 

24 

fg_bp2 

equ 

26 

fgjbp3 

equ 

28 

fg_bp4 

equ 

30 

wrt_mod 

equ 

36 

yi 

equ 

40 

patptr 

equ 

46 

pat ms k 

equ 

50 

multifill 

equ 

52 

clip 

equ 

54 

xmn_clip 

equ 

56 

ymn_clip 

equ 

58 

xmx_clip 

equ 

60 

ymx_clip 

equ 

62 


init 

equ 

$a000 

polygon 

equ 

$a006 


.dc.w 

init 

* address of variable block 

* 


from AO 

move . w 

SI, fg bpl <a0) 

*set colors for monochrome 

clr -w 

fg_bp2(a0> 


clr .w 

fg_bp3 (aO) 


clr.w 

fg_bp4 <a0) 


move - w 

S2,wrt mod(aO) 

* replace mode 
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move . 1 

#f ill, patptr (aO) * pointer of the fill pattern 


move . w 

#4,patmsk<a0) * four fill patterns 


clr .w 

multifill (aO) * for monochrome 


clr .w 

clip(aO) * no clipping 


move . 1 

contrl (aO) ,a6 * adddress of CONTRL array 

* 


from A6 


addq . 1 

#2,a6 * A6 > CONTRL < 1) 


move . w 

#3, (a6) * the XX pair in PTSIN 


move . 1 

ptsin <a0) , a6 * address PTSIN array from A6 


move . 1 

#tab, a5 * table of coordinates 


move • w 

#8,d3 * recieve 8 coordinates 

loop 

move .w 

(a5) +, (a6) + 


dbra 

d3, loop 


move.w 

#100, d3 * first scanline 

loopl 

move . w 

d3,yl (aO) * from Y1 


move . 1 

aO, - (sp) * restore address variable block 


dc.w 

polygon * fill scanline, AO destroyed 


move . 1 

{sp)+,a0 * AO restored 


addq . w 

#l,d3 * calculate next sacanline 


cmp.w 

#301, d3 * last scan line? 


bne 

loopl * no, next scanline 


move . w 

#l,-(sp) * Code CONIN wait for keypress 


trap 

#1 * Call GEMDOS 


addq . 1 

#2, sp * stack correction 

•* 

rts 

* subroutine all done 


move . w 

#0, - <sp) * terminate to desktop 


trap 

#1 * Call GEMDOS 

fill: 


dc.w 

%1100110011001100 


dc.w 

%0110110110110110 


dc.w 

%0011001100110011 


dc.w 

%1001100110011001 


tab: 

dc . w 

320, 100 


dc.w 

120,320 


dc.w 

520,300 


dc.w 

320, 100 
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The next example shows how the mouse form can be manipulated and how 
the mouse can be enabled. The example waits for a key press before 
returning. 


******************************************************** 

* 

* 

* show mouse - transform mouse 

* 

* 


******************************************** ************ 


intin 

equ 

8 




init_a 

equ 

$a000 




showmouse 

equ 

$a009 




transmouse 

equ 

$aOOb 




start : 

.dc.w 

init_a 

* 

address INIT from A5 



move . 1 

intin (aO) , a5 





move 

#0,6(aS) 

* 

INTIN (3) - mask color 

value 


move 

#1,8 (aS) 

* 

INTIN (4) - data color 

value 


add . 1 

#10, a5 

* 

a5 > INTIN (5) 



lea 

maus, a4 

* 

data for new cursor 



move 

#16,d0 

* 

32 words - 16 longs 


loop: 

move . 1 

<a4) +. (a5) + 

* 

transfer INTIN array 



dbra 

dO, loop 





.dc.w 

transmouse 

* 

and set form 



.dc.w 

init_a 





move . 1 

intin (aO) , aO 





clr .w 

(aO) 

* 

Number Hide Cursor -ignore call 


.dc.w 

show mouse 

* 

now the new cursor 
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* Code CON IN wait for keypress 

* Call GEMDOS 

* stack correction 

* subroutine all done 

* terminate to desktop 

* Call GEMDOS 


mans: 
maske : 

.dc.w %0000000110000000 
.dc.w % 0000011 U 1100000 

.dc.w %00011111111H000 
.dc.w %0111111111111110 
.dc.w 

.dc.w %1111001111001111 
.dc.w %imooiiiiooiin 
.dc.w *1111001111001111 
.dc.w %0000001111000000 
.dc.w *0000001111000000 
.dc.w *0000001111000000 
.dc.w *0000001111000000 
.dc.w *0000001111000000 
.dc.w %0000001111000000 
.dc.w *0000000000000000 

daten: 

.dc.w %0000000000000000 
.dc.w %0000000000000000 
.dc.w %0000000110000000 
.dc.w *0000011001100000 
.dc.w %0110000110000110 
.dc.w %0110000110000110 
.dc.w %0000000110000000 
.dc.w %0000000110000000 

.dc.w iOOOOOOOllOQQOOOO 

.dc.w %0000000110000000 
.dc.w %0000000110000000 
.dc.w %0000000110000000 
.dc.w %0000000110000000 
.dc.w *0000000000000000 
.dc.w %0000000000000000 
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3.5 The Exception Vectors 


The first 1024 bytes of the 68000 processor are reserved for the exception 
vectors. Routines which use exception handling store the addresses they 
require in this range of memory. 

A condition which leads to an exception can come either from the processor 
itself or from the peripheral components and controls units connected to it 
The interrupts, described in the next section, belong to the class of external 
events. In addition, a so-called bus error can be created externally. 

A bus error can be created by many circumstances. For one, certain memory 
areas can be protected from unauthorized access by it. As you may already 
know, the 68000 can run in one of two operating modes. The operating 
system is driven at the first level, the supervisor mode. The user mode is 
intended for user programs. In order that a user program not be able to 
access important system variables as well as the system components in an 
uncontrolled fashion, such an access in the user mode leads to a bus error. 
If such an error occurs, the processor stops execution of the instruction, 
saves the program counter and status register on the stack, and branches to a 
routine, the address of which it fetches from the lowest 1024 bytes of 
memory. In the case of the bus error, the address is at memory location 8 
(one long word). What happens in this routine? 

First the vector number of the interrupt is determined. In the case of a bus 
error, this is 2. Mushroom clouds are then displayed on the screen. The 
user can determine the vector number by counting the number of mushroom 
pictures. Execution then returns to the GEM desktop. 

The following table contains all of the exception vectors. 
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Vector number 
0 
1 
2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12-14 

15 

16-23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48-63 

64-255 


Address 

$000 

$004 

$008 

$00C 

$010 

$014 

$018 

$01C 

$020 

$024 

$028 

$02C 

$03G-$038 

$03C 

$040-$05C 

$060 

$064 

$068 

$06C 

$070 

$074 

$078 

$07C 

$080 

$084 

$088 

$08C 

$090 

$094 

$098 

$Q9C 

$0A0 

$0A4 

$0A8 

$0AC 

$0B0 

$0B4 

$0B8 

$0BC 


Exception vector meaning 
Stack pointer after reset 
Program counter after reset 
Bus error 
Address error 
Illegal instruction 
Division by zero 
CHK instruction 
TRAPV instruction 
Priviledge violation 
Trace 

Line A emulator 
Line F emulator 
reserved 

Uninitialized interrupt 
reserved 

Spurious interrupt 
Level 1 interrupt 
Level 2 interrupt 
Level 3 interrupt 
Level 4 interrupt 
Level 5 interrupt 
Level 6 interrupt 
Level 7 interrupt 
TRAP #0 instruction 
TRAP #1 instruction 
TRAP #2 instruction 
TRAP #3 instruction 
TRAP #4 instruction 
TRAP #5 instruction 
TRAP #6 instruction 
TRAP #7 instruction 
TRAP #8 instruction 
TRAP #9 instruction 
TRAP #10 instruction 
TRAP #11 instruction 
TRAP #12 instruction 
TRAP #13 instruction 
TRAP #14 instruction 
TRAP #15 instruction 


$0C0— $0FC reserved 


$100-$3FC User interrupt vectors 


235 


Abacus Software 


Atari ST Internals 


The following vectors are used on the ST: 


Line A emulator 

$EB9A 

Level 2 interrupt 

$543C 

Level 4 interrupt 

$5452 

TRAP #1 GEMDOS 

$965E 

TRAP #2 GEM 

$2A338 

TRAP #13 BIOS 

$556C 

TRAP #14 XBIOS 

$5566 


The vector for division by zero points to rte and returns directly to the 
interrupted program. Vectors 64-79 are reserved for the MFP 68901 
interrupts. All other vectors point to $5838 which outputs the vector number 
and ends the program as described for the bus error. 

All of the unused vectors can be used for your own purposes, such as the 
line F emulator or the 12 unused traps. 


3.S.1 The interrupt structure of the ST 


The interrupt possibilities which the 6800 microprocessor offers are put to 
good use in the ST. As you may have already gathered from the hardware 
description of the processor, the processor has seven interrupt levels with 
different priorities. The interrupt mask in the system byte of the status 
register determines which levels can generate an interrupt An interrupt can 
only be generated by a level higher than the current contents of the mask in 
the status register. A interrupt of a certain priority is communicated to the 
processor by the three interrupt priority level inputs. The following 
assignment results: 


Level 
7 (NMI) 
6 
5 
4 
3 
2 
1 
0 


IPL 2 
0 
0 
0 
0 
1 
1 
1 
1 


1 

0 

0 

1 

1 

0 

0 

1 

1 


0 

0 

1 

0 

1 

0 

1 

0 

1 
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If all three lines are 1 (interrupt level 0), no interrupt is present. Interrupt 
level 7 is the NMI (non-maskable interrupt), which is executed even if the 
interrupt mask in the status register contains seven. Which interrupt is 
assigned which vector (that is, the address of the routine which will process 
the interrupt) depends on the peripheral component which generates the 
interrupt For auto-vectors, the processor itself derives the interrupt number 
from the interrupt level. The following table is used in this process: 


Level 

Vector number 

Vector address 

IPL 1 

25 

$64 

IPL 2 

26 

$68 

IPL 3 

27 

$6C 

IPL 4 

28 

$70 

IPL 5 

29 

$74 

IPL 6 

30 

$78 

IPL 7 

31 

$7C 


Only lines 1PL I and IPL 2 are used on the Atari ST; Line IPL is 
permanently set to a 1 level so that only levels 2, 4 and 6 are available. The 
results in the following assignment: 

IPL 2 HBL, horizontal blank, line return 

IPL 4 VBL, vertical blank, picture return 

IPL 6 MFP 68901 

The HPL interrupt is generated on each line return from the video section. It 
is generated every 50 to 64 fis depending on the monitor connected 
(monochrome or color). It occurs very often and is normally not permitted 
by an interrupt mask of three. The standard HBL routine therefore only has 
the task of setting the interrupt mask to three if it is zero and allows the HBL 
interrupt so that no more HBL interrupts will occur. One use of the HBL 
interrupt could be for special screen effects. With the help of this routine, 
you know exactly which line of the screen has just been displayed. Of much 
greater importance, however, is the VBL interrupt, which is generated on 
each picture return. This occurs 50, 60, or 70 times per second depending 
on the monitor. 

The vertical blank interrupt (VBL) routine accomplishes a whole set of a 
tasks which must be periodically executed or which concern the screen 
display. When entering the routine, the frame counter fr clock ($466) is 
first incremented. Next, a test is made to see if the VBL interrupt is 
software-disabled. This is the case if vblsera ($452) (vertical blank 
semaphor) is zero or negative. In this case the routine is exited immediately 
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and execution returns to the interrupted program. Otherwise, all of the 
registers are saved on the stack and die counter vbclock ($462), which 
counts the executed VBL routines, is incremented. Next, a check is made to 
see if a different monitor has been connected in the meantime. If a change 
was made from a monochrome to color monitor, the video shifter is 
reprogrammed accordingly. This is necessary because the high screen 
frequency of 70 Hz of the monochrome monitor could damage a color 
monitor. The routine to flash the cursor is called next. If you load a new 
color palette via the appropriate BIOS functions or want to change the 
screen address, this happens here in the VBL routine. Since nothing is 
displayed at this time, a change can be made here without disturbing 
anything else. If colorptr ($45 A) is not equal to zero, it is interpreted as 
a pointer to a new color palette, and this is loaded into the video shifter. The 
pointer is then cleared again. If screenptr is set, this value is used as the 
new base address of the screen. This takes care of the screen specific 
portions. 

Now the floppy VBL routine is called, which with help the of the write 
protect status, determines if a diskette was changed. An additional task of 
this routine is to deselect the drives after the disk controller has turned the 
drive motor off. 

Now comes the most interesting part for the programmer, the processing of 
the VBL queue. There is a way to tell the operating system to execute your 
own routines within the VBL interrupt. The maximum number of routines 
possible is in nvbls ($454). This value is normally initialized to 8, but it 
can be increased if required. Address vblqueue ($456) contains a pointer 
to a vector array which contains the (8) addresses of the VBL routines. Each 
address is tested within the VBL routine and the corresponding routine 
executed if the address is not zero. 

If you want to install your own VBL routine, check the 8 entries until you 
find one which contains a zero. At this address you can write a pointer to 
your routine which from now on will be executed in every VBL interrupt. 
In all 8 entries are already occupied, you can copy the entries into a free area 
of memory, append the address of your routine, and redirect vblqueue to 
point to the new vector array. Naturally, you must not forget to increment 
vbls, the number of routines, correspondingly. Your routine may change 
all registers with the exception of the USP. 

As soon as the VBL routine is done, the dmpf lg ($4EE) is checked. If this 
memory location is zero, a hardcopy of the screen is outputted. The flag is 
set in the keyboard interrupt routine if the keys ALT and HELP are pressed 
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at the same time. Finally, the register contents are restored, vblsem is 
released and execution returns to the interrupted routine. 

The MFP 68901 occupies interrupt level six in our previous table. This 
component is in the position to create interrupt vectors on its own. These are 
referred to non-auto vectors in contrast to the auto vectors used above, 
because the processor does not generate the vector itself. In the Atari ST, 
the MFP 68901 works as the interrupt controller. It manages the interrupt 
requests of all peripheral components including its own. 

The MFP can manage sixteen interrupts which are prioritized in reference to 
each other, similar to the seven levels of the processor. All MFP interrupts 
appear on level 6 to the 68000, therefore prioritized higher than HBL and 
VBL interrupts. The following table contains the assignments within the 
MFP. 

Level Assignment 

15 Monochrome monitor detect 

14 RS-232 ring indicator 

13 System clock timer A 

12 RS-232 receive buffer full 

11 RS-232 receive error 

10 RS-232 transmit buffer empty 

9 RS-232 transmit error 

8 Line return counter, timer B 
7 Floppy controller and DMA 

6 Keyboard and MIDI ACIAs 

5 Timer C 

4 RS-232 baud rate generator, timer D 

3 unused 

2 RS-232 CTS 

1 RS-232 DCD 

0 Centronics busy 

Not all of these possible interrupt sources are enabled, however. Some 
signals are processed through polling. The following is a description of the 
interrupts which are used by the operating system. 
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Level 2, RS-232 CTS, Address $73C0 

This interrupt is generated every time the RS-232 interface is informed via 
the CTS line that a connected receiver is ready to receive additional data. 
The routine then sends the next character from the RS-232 transmit buffer. 


Level 5, Timer C, Address $7C5C 

This timer runs at 200 Hz. The 200 Hz counter at $4B A is first incremented 
in the interrupt routine. The next actions are performed only every fourth 
call to the interrupt routine, that is, only every 20ms (50 Hz). First a routine 
is called which handles the sound processing. Another task of this interrupt 
is the keyboard repeat when a key is pressed and initial repeat. Finally, the 
evt timer routine of GEM is called, which is accessed via vector $400. 


Level 6, Keyboard and Midi, Address $752A 

Two peripheral components are connected to this interrupt level of the MFP, 
the two ACIAs which receive data from the keyboard and the MIDI 
interface. In order to decide which of the two components has requested an 
interrupt, the interrupt request bits in the status registers of the ACIAs are 
tested and the received byte is fetched if required. If it comes from the 
keyboard, the scan code is converted to the ASCII code by means of the 
keyboard table and written into the receive buffer, which happens 
immediately for MIDI data. Mouse and joystick data also come from the 
keyboard ACIA and are also prepared accordingly. 


Level 9, RS-232 transmit error, Address $7426 

If an error occurs while sending RS-232 data, this interrupt routine is 
activated. Here the transmitter status register is read and the status is saved 
in the RS-232 parameter block. 


Level 10, RS-232 transmit buffer empty, Address $7374 

Each time the MFP has completely outputted a data byte via the RS-232 
interface, it generates this interrupt. It is then ready to send the next byte. If 
data is still in the transmit buffer, the next byte is written into the transmit 
register, which can now be shifted out according to the selected baud rate. 
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Level 11, RS-232 receive error. Address $7408 

If an error occurs when receiving RS-232 data, this interrupt routine is 
activated. This may involve a parity error or an overflow. The routine only 
clears the receiver status register and then returns. 


Level 12, RS-232 receive buffer full. Address $72C0 

If the MFP has received a complete byte, this interrupt occurs. Here the 
character can be fetched and written into the receive buffer (if there is still 
room). This routine takes into account the active handshake mode (sending 
XON/XOFF or RTS/CTS). 

The other interrupt possibilities of the MFP are not used, but they can be 
used for your own routines. For example, interrupt level 0, Centronics 
strobe, can be used for buffered printer output. 


241 



Abacus Software 


Atari ST Internals 


3.6 The Atari ST VT52 Emulator 


There are two options for text output on the ST. You can work with the 
GEMDOS functions by means of TRAP # 1 or a direct BIOS call with 
TRAP #13. The other possibility consists of using the VDI functions. 

You have special possibilities for screen control with both variants. We will 
first take a look at output using the normal DOS or BIOS calls. Here a 
terminal of type VT52, which offers a wide variety of control functions, is 
emulated for screen output. These control characters are prefixed with a 
special character, the escape code. Escape, also shortened to ESC, has 
ASCII code 27. Following the escape code is a letter which determines the 
function, as well as additional parameters if required. The following list 
contains all of the control codes and their significance. 


ESC A Cursor up 

This function moves the cursor up one line. If the cursor was already 
on the top line, nothing happens. 


ESC B Cursor down 

This ESC sequence positions the cursor one line down. If the cursor 
is already on the bottom line, nothing happens. 


ESC C Cursor right 

This sequence moves the cursor one column to the right. 


ESC D Cursor left 

Moves the cursor one position to the left This function is identical to 
the control code backspace (BS, ASCII code 8). If the cursor is 
already in the first column, nothing happens. 


ESC E Clear Home 

This control sequence clears the entire screen and positions the cursor 
in the upper left comer of the screen (home position). 
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ESC H Cursor home 

With this function you can place the cursor in the upper left comer of 
the screen without erasing the contents of the screen. 


ESC I Cursor up 

This sequence moves the cursor one line towards the top. In contrast 
to ESC A, however, if the cursor is already in the top line, a blank 
line is inserted and the remainder of the screen is scrolled down a line 
correspondingly. The column position of the cursor remains 
unchanged. 


ESC J Clear below cursor 

By means of this function, the rest of the screen below the current 
cursor position is cleared. The cursor position itself is not changed. 


ESC K Clear remainder of line 

This ESC sequence clears the rest of the line in which the cursor is 
found. The cursor position itself is also cleared, but the position is 
not changed. 


ESC L Insert line 

This makes it possible to insert a blank line at the current cursor 
position. The remainder of the screen is shifted down; the lowest line 
is then lost. The cursor is placed at the start of the new line after the 
insertion. 


ESC M Delete line 

This function clears the line in which the cursor is found and moves 
the rest of the screen up one line. The lowest screen line then 
becomes free. After the deletion, the cursor is located in the first 
column of the line moved up to take the place of the old one. 
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ESC Y Position cursor 

This is the most important function. It allows the cursor to be 
positioned at any place on the screen. The function needs the cursor 
line and column as parameters, which are expected in this order with 
an offset of 32. If you want to set the cursor to line 7, column 40, 
you must output the sequence ESC Y CHR$(32+7) CHR$(32+40). 
Lines and columns are counter starting at zero; for an 80x25 screen 
the lines are numbered from 0 to 24 and the columns from 0 to 79. 

The additional ESC sequences of the VT52 terminal start with a lower case 
letter. 

ESC b Select character color 

With this function you can select the character color for further 
output. With a monochrome monitor you have choice between just 
0=white and l=black. For color display you can select from 4 or 16 
colors depending on the mode. Only the lowest four bits of the 
parameters are evaluated (mod 16). You can use the digit " 1" for the 
color 1 as well as the letters "A” or "a" in addition to binary one. 


ESC c Select background color 

This function serves to select the background color in a similar 
manner. If you choose the same color for character and background, 
you will, of course, not be able to see text output any more. 


ESC d Clear screen to cursor position 

This sequence causes the screen to be erased starting at the top and 
going to the current position of the cursor, inclusive. The position of 
She cursor is not changed. 


ESC e Enable cursor 

Through this escape sequence the cursor becomes visible. The cursor 
can, for example, be enabled when waiting for input from the user. 


ESC f Disable cursor 

Turns the cursor off again. 
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ESC 

ESC 

ESC 

ESC 

ESC 

ESC 

ESC 

ESC 


j Save cursor position 

If you want to save the current position of the cursor, you can use 
this sequence to do so. 


k Set cursor to the saved position 

This is the counterpart of the above function. It sets the cursor to the 
position which was previously saved with ESC j. 


1 Clear line 

Clears the line in which the cursor is located. The remaining lines 
remain unaffected. After the line is cleared, the cursor is located in the 
first column of the line. 


o Clear from start 

This clears the current cursor line from the start to the cursor position, 
inclusive. The position of the cursor remains unchanged. 


p Reverse on 

The reverse (inverted) output is enabled with this sequence. For all 
further output, the character and background colors are exchanged. 
With a monochrome monitor you get white type on a black 
background. 


q Reverse off 

This sequence serves to re-enable the normal character display mode. 


v Automatic overflow on 

After executing this sequence, an attempted output beyond the end of 
line will automatically start a new line. 


w Automatic overflow off 

This deactivates the above sequence. An attempt to write beyond the 
line will result in all following characters being written in the last 
column. 
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Similar functions are available to you under VDI. The VDI escape functions 
(opcode 5) serve this purpose. The appropriate screen function is selected 
by choosing the proper function number. Note, however, that under VDI 
the line and column numbering does not begin with zero but with one. 

Under VDI there is also a function which outputs a string at specific screen 
coordinates. If necessary, you can use the ESC functions of the VT52 
emulation in addition. 

The output of ’’unprintable" control characters 

The three system fonts of the ST have also been supplied with characters for 
the ASCII codes zero to 31, which are normally interpreted as control 
codes. On the ST, only codes 7 (BEL), 8 (BS backspace), 9 (TAB), as well 
as 10, 11, and 12 (LF linefeed, VT vertical tab, and FF form feed all 
generate a linefeed) plus 13 (CR carriage return) have effect, in addition to 
ESC. The remaining codes have no effect. How does one access the 
characters below 32? 

To do this, an additional device number is provided in the BIOS function 3 
’’conout’’. Normally number 2 "con" serves for output to the screen. If one 
selects number 5, however, all the codes from, 0 to 255 are outputted as 
printable characters, control codes are no longer taken into account. 

In the appendix you find the three ST system fonts pictured. 
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3.7 The ST System Variables 


The ST uses a set of system variables whose significance and addresses will 
not change in future versions of the operating system. If you use other 
variables, such as those from the BIOS listing which are not listed here, you 
should always remember that these could have a different meaning in a new 
version of the operating system. The system variables are in the lower RAM 
area directly above the 68000 exception vectors, at address $400 to 1024. 
The address range from 0 to $800 (2048) can be accessed only in the 
supervisor mode. An access in the user mode of the 68000 leads to a bus 
error. 

In the following listing we will use the original names from Atari. In 
addition to the address of the given variable, typical contents and the 
significance will be described 

Address length name Sample contents 

$400 L etv__tiraer $F52 6 

This is the event timer vector of the GEM. It takes care of the periodic 
tasks of GEM. 

$404 L etv_critic $55 62 

Critical error handler. Under GEM this pointer points to $2A156. 
There an attempt is made to correct disk errors, such as if a another 
disk is requested in a single-drive system. 

$408 L etv_tena $532 8 

This is the GEM vector for ending a program. 

$40C 5L etv_xtra 

Here is space for 5 additional GEM vectors, which at the time are not 
yet used. 
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$420 lx memvalid $752G19F3 

If the memory location contains the given value, the configuration of 
the memory controller is valid. 

$424 W memctrl $0400 

This is a copy of the configuration value in the memory controller. 
The value given applies for a 512K machine. 

$426 L resvalid $31415926 

If the given value is located here, a jump is made at a reset via the 
reset vector in address $42A. 

$42A L resvector $FC0008 

See above. 

$42E L phystop $80000 

This is the physical end of the RAM memory; $80000 for a 512K 
machine. 

$432 L __membofc $3B900 

The user memory begins here (TP A, transient program area). 

$436 L _memtop $7 8 0 00 

This is the upper end of the user memory. 

$43A lx memval2 $2 37 6 98 AA 

This "magic” value together with "memvalid" declares the memory 
configuration valid. 

$43E M flock 0 

If this variable contains a value other than zero, a disk access is in 
progress and the VBL disk routine is disabled. 
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$440 W seekrate 3 

The seek rate (the time it takes to move the read/ write head to the next 
track) is determined according to the following table: 


Seek rate Time 

0 6 ms 

1 12 ms 

2 2 ms 

3 3 ms 


$442 W _timer_ras $14, 20 ms 

The time span between two timer calls, 20 ms corresponds to 50 Hz. 


$444 W fverify $FF 

If this memory location contains a value other than zero, a verily is 
performed after every disk write access. 


$446 W _bootdev 0 

Contains the device number of the drive from the operating system 
was loaded. 


$448 W palmode 0 

If this variable contains a value other than zero, the system is in the 
PAL mode (50 Hz); if the value is zero, it means the NTSC mode. 

$44A W defshiftmod 0 

If the Atari is switched from monochrome to color, it gets the new 
resolution from here (0=low, 1 medium resolution). 

$44C W sshiftmod $2 0 0 

Here is a copy of the register contents for the screen resolution. 

0 320x200, low resolution 

1 640x200, medium resolution 

2 640x400, high resolution 
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$44E L vbasad $7 80 00 

This variable contains a pointer to the video RAM (logical screen 
base). The screen address must always begin on a 256 byte 
boundary. 

$452 W vblsem 1 

If this variable is zero, the vertical blank routine is not executed. 

$454 W nvbls 8 

Number of vertical blank routines. 

$456 L _vblqueue $4CE 

Pointer to a list of nvbls routines which will be executed during the 
VBL. 

$45A Za colorptr 0 

If this value is not zero, it is interpreted as a pointer to a color palette 
which will be loaded at the next VBL. 

$45E L screenpt 0 

This is a pointer to the start of the video RAM, which will be set 
during the next VBL (zero if no new address is to be set). 

$462 z. _vbclock $2D26A 

Counter for the number of VBL interrupts. 

$466 L __f rclock $2D2 67 

Number of VBL routines executed (not disabled by vblsem). 

$4 6A L hdv_init $5AE8 

Vector for hard disk initialization. 
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$46E L swv_vec $5 01E 

Vector for changing the screen resolution. A branch is made via this 
vector with the screen resolution is changed (default is reset). 

$472 L hdv__bpb $5B6E 

Vector to fetch the BIOS parameter block for a hard disk. 

$476 L hdv_rw $5D8 8 

Read/write routine for a hard disk. 

$47A L hdv_boot $6 0B2 

Vector to a routine to reboot the hard disk. 

$47E L hdv_raediach $5DlE 

Media change routine for hard disk. 

$482 w _comload 0 

If this variable is set to a value other than zero by the boot program, 
an attempt will be made to load a program called "COMMAND.PRG" 
after the operating system is loaded. 

$484 B conteim 6 

Attribute vector for console output 

Bit Meaning 

0 Key click, on/off 

1 Key repeat on/off 

2 Tone after CTRL G on/off 

3 "kbshift" is retured in bits 24-31 for the 
BIOS function "conin" 

$485 B unused, reserved 

$486 L trpl4ret 0 

Return address for TRAP #14 call. 
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$48A L criticret 0 

Return address of the critical error handler 
$48E 4L themd 0 

Memory descriptor, filled out by the BIOS function getmpb. 

$49E 2W md 0 

Space for additional memory descriptors. 

$4A2 L savptr $5CE 

Pointer to a save area for the processor registers after a BIOS call. 

$4A6 W _nflops 2 

Number of connected floppy disk drives. 

$4A8 L con_state $ 8 AEE 

Vector for screen output; set by ESC functions to the appropriate 
routine, for example. 

$4 AC W save_row 0 

Temporary storage for cursor line when positioning the cursor with 
ESC Y. 

$4AE L sav__context 0 

Pointer to a temporary areas for exception handling. 

$4B2 2L _buf 1 $4F9E , $4FB2 

Pointer to two buffer list headers of GEMDOS. The first header is 
responsible for data sectors, the second for the FAT (file allocation 
table) and the directory. Each buffer control block (BCB) is 
constructed as follows: 
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long 

BCB 

$4F8A, 

pointer to next BCB 

int 

drive 

“1/ 

drive number or —1 

int 

type 

2 

buffer type 

int 

rec 

$41C 

record number in this buffer 

int 

dirty 

0 

dirty flag (buffer changed) 

long 

DMD 

$2854 

pointer to drive media descriptor 

long 

buffer 

$4292 

pointer to the buffer itself 

$4BA L 

_hz_200 


$71280 

Counter for 200 Hz system clock 

$4BC 4B 

the env 

0 


Default environment string, four zero bytes. 

$4C2 L _drvbits 3 

32-bit vector for connected drives. Bit 0 stands for drive A, bit 1 for 
drive B, and so on. 

$4C6 L _dskbufp $12BC 

Pointer to a 1024-byte disk buffer. The buffer is used for GSX 
graphic operations and should not be used by interrupt routines. 

$4CA L _autopath 0 

Pointer to autoexecute path. 

$4CE 8X> _vbl_list $15398, 0,0... 

List of the standard VBL routines. 

$4EE W _dumpflg $FFFF 

This flag is incremented by one when the ALT and HELP keys are 
pressed simultaneously. A value of one generates a hardcopy of the 
screen on the printer. A hardcopy can be interrupted by pressing ALT 
HEL P again. 
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$4FG W _prfcafc>fc 0 

Printer abort flag due to time-out. 

$4F2 L _sy3ba3e $5000 

Pointer to start of the operating system. 

$4F6 L _shell_p 0 

Global shell information. 

$4FA L end_oa $3B900 

Pointer to the end of the operating system in RAM, start of the TP A. 

$4FE L exec_oa $1EB00 

Pointer to the start of the AES. Normally branched to after the 
initialization of the BIOS. 
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3.8 The 68000 Instruction Set 


If you are already familiar with the machine language of some 8-bit 
processor: Forget everything you know. If you do, it will make it easier to 
understand the following material! 

The 68000 processor is fundamentally different in construction and 
architecture from previous processors (including the 8086!). The essential 
difference does not lie in the fact that the standard processing width is 16 
and not 8 bits (which is sometimes a drawback and can lead to 
programming errors), but in the fact that, with certain exceptions, the 
internal registers are not assigned to a specific purpose, but can be viewed 
as general-purpose registers, with which almost anything is possible. 

In eariler processors, the accumulator was always the destination for 
arithmetic operations, but it is completely absent in the 68000. There are 
eight data registers (D0-D7) with a width of 32 bits, and as a general rule, at 
least one of these is involved in an operation. There are also eight address 
registers (AO- A7), each with 32 bits, which are usually used for generating 
complex addresses. Register A7 has a set assignment-it serves as the stack 
pointer. It is also present twice, once as the user stack pointer (USP) and 
once as the supervisor stack pointer (SSP). The distinction is made because 
there are also two operating modes, namely the user mode and the 
supervisor mode. 

These two are not only different in that they use different stack pointers, but 
in that certain instructions are not legal in the user mode. These are the 
so-called priviledged instructions (see also instruction description), with 
whose help an unwary programmer can easily "crash" the system rather 
spectacularly. This is why these instructions create an exception in the user 
mode. An exception, by the way, is the only way to get from the user mode 
to the supervisor mode. 

In addition there is the status register, the upper half of which is designated 
as the system byte because it contains such things as the interrupt mask, 
things which do not concern the "normal" user, making access to this byte 
also one of the priviledged instructions. The lower byte, the user byte, 
contains the flags which are set or cleared based on the result of operations, 
such as the cany flag, zero flag, etc. As a general rule, the programmer 
works with these flags indirectly, such as when the execution of a branch is 
made conditional on the state of a flag. 
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Two things should be mentioned yet: Multi-byte values (addresses or 
operands) are not stored in memory as they are with 8-bit processors, in the 
order low byte/high byte, but the other way around. Four-byte expressions 
(long word) are stored in memory (and the registers of course) with the 
highest-order byte first. 

The second is that unsupported opcodes do not lead to a crash, but cause a 
special exception, whose standard handling must naturally be performed by 
the operating system. 


3.8.1 Addressing modes 


This is probably the most interesting theme of the 68000 because the 
enormous capability first takes effect through the many various addressing 
modes. 

The effective address (the address which, sometimes composed of several 
components, finally determines the operand) is fundamentally 32 bits wide, 
even if one or more the components specified in the instruction is shorter. 
These are always sign-extended to the full 32-bit width. 

The charm of the addressing lies in the fact that almost all instructions 
(naturally with exceptions), both the source and destination operands, can 
be specified with one of the addressing modes. This means that even 
memory operations do not necessarily have to use one of the registers; 
memory-to-memory operations are possible. 

In the assembler syntax, the source operand is given first, followed by the 
destination operand (behind the comma). 
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Register Direct 

The operand is located in a register. There are two kinds of register direct 
addressing: data register direct and address register direct 

In the first case, the operand may be bit, byte, word, or long word-oriented; 
in the second case a word or long word is required, in case the address 
register is the destination of the operation. 

Example: ADD . B D0,D1 or ADDA.W D0,A2 


Absolute Data Addressing 

The operand is located in the address space of memory. This can also be a 
peripheral component, naturally (see MOVEP). The address is specified in 
absolute form. 

This can have a width of a a long word, whereby the entire address space 
can be accessed, or it can be only one word wide. In this case is 
sign-extended (the sign being the highest-order bit) to 32 bits. For example, 
the word $ 7FFF becomes the long word $00007FFF, while $FFFF 
becomes $FFFFFFFF. Only the lower 32K and the upper 32K of the 
address space can be accessed with the short form. This addressing mode is 
often used in the operating system of the ST because important system 
variables are stored low in memory and all peripheral components are 
decoded at the top. 

Example: MOVE.L $7FFF, $01234567 

Instructions in which both operands are addressed with a long word are the 
longest instructions in the set, consisting of 10 bytes. 


257 


Abacus Software 


Atari ST Internals 


Program Counter Relative Addressing 

This addressing mode allows even constants to be addressed in a completely 
relocatable program, since the base of the address calculation is the current 
state of the program counter. 

The are two variations. In the first, a 16-bit signed offset is added to the 
program counter, and in the second, the contents of a register 
(sign-extended if only one word is specified) are also added in, though here 
the offset may be only 8 bits long. 

Example: MOVE.B $1234 (PC) , $12 (PC, DO .W) 

Register Indirect Addressing 

There are several variations of this, and they will be discussed individually. 
Register Indirect 

Here the operand address is located in an address register. 

Example: CLR . L ( AO ) 

Postincrement Register Indirect 

The operand is addressed as above, but the contents of the address register 
are then incremented by the length of the operand, by 1 for xxx.B or 4 for 
xxx.L. 

Example: BSET.B #0, (AO) + or BCLR.L #23, (Al) + 
Predecrement Register Indirect 

Here the address register is decrement by the length of the operand before 
the addressing. 

Example: EOR.L DO, $1234 (A4) 


258 


Abacus Software 


Atari ST Internals 


Indexed Register Indirect with Offset 

As above, but the contents of another register (address or data) are also 
added in, taking the sign into account. The offset may have a width of 8 bits 
here, however. 

Example: move . w $12 (A5,A6.L) ,D1 


Immediate Addressing 

Here the operand is contained as such in the instruction itself. Naturally, an 
operand specified in this manner can serve only as a source. The immediate 
operands can, as a general rule, be any of the allowed widths. 

Example: ADDI.W #$1234, D5 

In the variant QUICK, the constant may be only 3 bits long, therefore 
having a value from 0-7. An exception is the MOVE command, where the 
constant may have 8 bits, but in which only a data register is allowed as the 
destination. 

Example: ADDQ.L #1,A0 or MOVEQ #123, D1 


Implied Register 

This addressing mode is mentioned only for the sake of completeness and in 
it, an operand address is already determined by the instruction itself. The 
operands are either in the program counter, in the status register, or the 
system stack pointer. 

Example: MOVE SR,D6 

Regarding the offsets, it should be noted that they are signed numbers in 
two's complement. Their highest-order bit forms the sign. With an 8-bit 
value, an offset of + 127/-128 is possible, and about ±32K with 16 bits. 
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3.8.2 The instructions 


In the following instruction description, the individual bit patterns are not 
listed since this would lead to far in this connection. Additonal information 
can be gathered from books like the M68000 161 32 -Bit Microprocessor 
Programmer's Reference Manual (Motorola). 

The instructions are also explained only in their base form and variations are 
mentioned only in name. We will briefly explain what the individual 
variations can look like here. 

The variations are indicated by letter after the operand. This can be one of 
the following: 

A indicates that the destination of the operation is an address register. 
Word operations are sign-extended to 32 bits. 

I indictaes an immediate operand as the source of the operation. I 
operands may assume all widths as a general width. 

Q means quick and represents a special form of immediate addressing. 
Such an operand is usually three bits wide, corresponding to a value 
range of 0 to 7. This limited range has the advantage that the operand 
will fit into the opcode. Since there is no special command for 
incrementing a register, something like ADDQ.L #1,A0 works well in 
its place. An exception is MOVEQ. Here the operand may have a value 
of 0-255. 

X indicates arithmetic operations which use the X flag. This flag has a 
special significance. It is set equal to the carry flag for all arithmetic 
operations. The carry flag, however, is also affected by transfer 
operations while the X flag is not so that it remains available for further 
calculations. This is especially useful for computations with higher 
precision than the standard 32 bits, where temporary results must first 
be saved, and where the carry flag can be changed as a result. 

AU instructions have a suffix after the opcode of the form .B, .W, or .L. 
This suffix indicates the processing width of the operation. Although a data 
register, for example, has a width of 32 bits = 4 bytes = 1 long word, the 
instruction CLR.B DO clears only the lowest-order byte of the register. For 
registers, .W specifies the lower word. The higher-order word is not 
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explicitly addressable. If the operand is in memory, it is imporant to know 
that .W and .L operands must begin on an even address. The same applies 
for the opcode as such, which also always comprises one word. 

If the destination of an operation is an address register, only operands of 
type .W and .L are allowed, whereby the first is sign-extended to a long 
word. 

Some listings contain instructions of the form MOVE.L #27, DO. The 
programmer then assumes that the assembler will produce #$000000 IB 
from #27. 

Now to the individual instructions: 

ABCD Add Decimal with Extend 

There is one data format which we have not yet discussed: the BCD 
format. This means nothing more than "Binary-Coded Decimal" and it 
uses digits in the range 0-9. Since this information requires only 4 bits, 
a byte can store a two-digit decimal number. The instruction ABCD can 
then add two such numbers. The processing width is always 8 bits. 

ADD Add Binary 

This instruction simply adds two operands. 

Variations are ADDA, ADDQ, ADDI, and ADDX. 

AND Logical AND 

Two operand are logically combined with each other according the 
AND function. 

Variation: ANDI 

ASL Arithmetic Shift Left 

The operand is shifted to the left byte by the number of positions given, 
whereby the highest-order bit is copied into the C and X flags. A 0 is 
shifted in at the right. If a data register is shifted, the processing width 
can be any. The number of places to be shifted is either specified as an I 
operand (3 bits) or is placed in an additional register. If a memory 
location is shifted, the processing width is always one word. A counter 
is then not given; it is always =1. 

ASR Arithmetic Shift Right 

The operand is shifted to the right, whereby the lowest bit is copied to 
C and X. The sign bit is shifted over from the left. See ASL for 
information about processing width and counter. 
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Bcc Branch Conditionally 

The branch destination is always a relative address which is either one 
byte or one word long (signed!). Correspondingly, the branch can 
jump over a range of + 127/-128 bytes or +32K-1/-32K. The point of 
reference is the address of the following instruction. 

Whether or not this instruction is actually executed depends on the 
required condition, which is verified by means of the flags. Here are the 
variations and their conditions. A minus sign before a flag indicates that 
it must be cleared to satisdy the condition. Logical operations are 
indicated with for AND and "/" for OR. 


BRA 

Branch Always 

no condition 

BCC 

Branch Carry Clear 

-C 

BCS 

Branch Carry Set 

C 

BEQ 

Branch Equal 

Z 

BGE 

Brangh Greater or Equal 

N*V/-N*-V 

BGT 

Branch Greater Than 

n *v*-z/-n*-v*-z 

BHI 

Branch Higher 

-c*-z 

BLE 

Branch Less or Equal 

Z/N*-V/-N*V 

BLS 

Branch Lower or Same 

c/z 

BLT 

Branch Less Than 

N*-V/-N*V 

BMI 

Branch Minus 

N 

BNE 

Branch Not Equal 

-Z 

BPL 

Branch Plus 

-N 

BVC 

Branch Overflow Clear 

-V 

BVS 

Branch Overflow Set 

V 


BCHG Bit Test and Change 

The specified bit of the operand will be inverted. The original state can 
be determined from the Z flag. The operand is located either in memory 
(width=.B) or in a data register (width =.L). The bit number is given 
either as an I operand or is located in a data register. 

BCLR Bit Test and Clear 

The specified bit is cleared. Everything else is handled as per BCHG. 
BSET Bit Test and Set 

The specified bit is set. Boundary conditions are per BCHG. 

BSR Branch to Subroutine 

This is an unconditional branch to a subroutine. Branch distances as for 
Bcc. 
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BTST Bit Test 

The bit is only checked as to its condition. Everything else as per 
BCHG. 

CHK Check Register Against Boundaries 

A data register is checked to see if its contents are less than zero or 
greater than the operand. Should this be the case, the processor 
executes an exception. The program is continued at the address in 
memory location $18 (vector 6). Otherwise no action is taken. The 
processing width is only word. 

CLR Clear Operand 

The specified operand is cleared (set to zero). 

CMP Compare 

The first operand is subtracted from the second without changing either 
of the two operands. Only the flags are set, according to the result. 
Variations: CMP A and CMPI 

Both operands are addresses with the addressing mode (Ax)+ with the 
variant CMPM. 

DBcc Test Condition, Decrement and Branch 

A data register is decremented and the flags are checked for the 
specified condition. A branch is performed if either the condition is 
fulfilled or the register is -1. Branch conditions and ranges as per Bcc. 

DIVS Divide Signed 

The second operand is divided by the first operand, taking the sign into 
account Afterwards the second operand contains the integer quotient in 
the lower word and the remainder in the upper word, which has the 
same sign as the quotient. The data width of the first operand is set at 
.W and at .L for the second. 

DIVU Divide Unsigned 

Operation as above, but the sign is ignored. 

EOR Exclusive OR 

The two operands are logically combined according to the rules of 
EXOR. 

Variations: EORI 
EXG Exchange Registers 

The two registers specified are exchanged with each other. 
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EXT Sign Extend 

The operand is filled to the given processing width with its bit 7 (in the 
case of .B) or bit 15 (.W). 

JMP Jump 

Unconditional jump to the specified address. The difference between 
this and BRA is that here die address is not relative but absolute, that is, 
the actual jump destination. 

JSR Jump to Subroutine 

Jump to a subroutine. The difference from BSR is as above. 

LEA Load Effective Address 

This often-misunderstood instruction loads an address register not with 
the contents of the specified operand address as is normal for the other 
instructions, but with the address as such ! 

LINK Link Stack 

This instruction first places the given address register on the stack. The 
contents of the stack pointer (A7) are then placed in this register and the 
offset specified is added to the stack pointer. 

With this practical instruction, data areas can be reserved for a 
subroutine, without having to make room in the program itself, which 
would also be impossible in programs which run in ROM. The 
C-compiler makes extensive use of this capability for local variables. 

LSL Logical Shift Left 

Function and limitations as per ASL. 

LSR Logical Shift Right 

Function and limitations as per ASR, except here the sign is not shifted 
in on the left, but a 0. 

MOVE 

The first operand is transferred to the second. 

Variations: MOVEA, MOVEQ 

MOVEM Move Mulitple Registers 

Here an operand can consist of a list of registers. This can be used to 
place all of the registers on the stack, for instance. 

Example: MOVEM.L A0-A6/D0-D7,-(A7) 
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MO YEP Move Peripheral Data 

This speciality is made expressly for the operation of peripheral 
components. As a general rule, these work only with an 8-bit data bus, 
and are are then connected only to the upper or lower 8 bits of the 
68000's data bus. If a word or long word is to be transferred, the bytes 
must be passed over either the upper or lower byte of the data bus, 
depending on whether the address is even or odd. The address is then 
always incremented by two so that the transfer always continues on the 
same half of the data bus on which it was begun. Corresponding to the 
purpose of this instruction, one operand is always a data register, and 
the other is always of type register indirect with offset. 

MULS Multiply Signed 

Signed multiplication of two operands. 

MULU Multiply Unsigned 

Multiplication of two operands, ignoring the sign. 

NBCD Negate Decimal with Extend 

A BCD operand is subjected to the operation O-operand X. 

NEG Negate Binary 

The operand is subjected to the treatment 0-operand. 

Variations: NEGX 

NOP No Operation 

As the name says, this instruction doesn’t do anything. 

NOT One’s Complement 
The operand is inverted. 

OR Logical OR 

The two operands are combined according to the rule for logical OR. 

PEA Push Effective Address 

The address itself, not its contents, is placed on the stack. 

RESET Reset External Devices 

The reset line on the 68000 is bidirectional. Not only can the processor 
be externally reset, but it can also use this instruction to reset all of the 
peripheral devices connected to the reset line. 

This is a priviledged instruction! 
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ROL Rotate Left 

The operand is shifted to the left, whereby the bit shifted out on the left 
will be shifted back in on the right and the cany flag is affected. 
Processing widths and shift counter as per ASL. 

ROR Rotate Right 

As above, but shift from left to right. 

ROXL Rotate Left with Extend 

As ROL, but the shifted bit is first placed in the X flag, the previous 
value of which is shifted in on the right 

ROXR Rotate Right with Extend 

As above, but reversed shift direction. 

RTE Return from Exception 

Return from an exception routine to the location at which the exception 
occurred. 

RTS Return from Subroutine 

Return froma subroutine to the location at which it was called. 

RTR Return and Restore 

As above, but the CC register (the one with the flags) is first fetched 
from the stack (on which it must have first been placed, because 
otherwise execution will not return to the proper address. 

SBCD Subtract Decimal with Extend 

The first operand is subtracted from the second. Refer to ABCD for 
information on the data format 

See Set Conditionally 

The operand (only .B) is set to $FF if the condition is fulfilled. 
Otherwise it is cleared. Refer to Bcc for the possible condition codes. 

STOP 

The processor is stopped and can only be called back to life through an 
external interrupt. 

This is a priviledged instruction! 

SUB Subtract Binary 

The first operand is subtracted from the second. 
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SWAP Swap Register Halves 

The two halves of a data register are exchanged with each other. 

TAS Test and Set Operand 

The operand (only .B) is checked for sign and 0 (affecting the C and N 
flags). Bit 7 is then set to 1. 

TRAP 

The applications programmer uses this instruction when he wants to call 
functions of the operating systems. This instruction generates an 
exception, which consists of continuing the program at the address 
determined by the given vector number. See the chapter on the BIOS 
and XBIOS for the use of this instruction. 

TRAPV Trap on Overflow 

If the V flag is set, an exception is generated by this instruction, 
resulting in program execution continuing at the address in vector 7 
($1C). 

TST Test 

Action like TAS, but the operand is not changed. 

UNLK Unlink 

This instruction is the counterpart of LINK. The stack pointer ( A7) is 
loaded with the given address register and this is supplied with the last 
stack entry. In this manner the area reserved with LINK is released. 

Addendum to the condition codes: The conditions listed under Bcc are not 
complete, because the additional conditions do not make sense at that point. 
But the instrutions DBcc and See have the additional variations T (DBT, 
ST) and F (DBF, SF). T stands for true and means that the condition is 
always fulfilled. F stands for false and is the opposite: the condition is never 
fulfilled. 
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3.9 The BIOS Listings - Version I 
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005A90 2B1C00FF82400666 move.l #$FF8240, $666 (A5) Address to color palette 

005A98 426D066E clr.w S66E(A5) Clear mask pointer 

005A9C 322D0A8C move.w $A8C(A5),D1 Get printer configuration 




005AAO E64 9 lsr.w #3,D1 Test / quality mode 

005AA2 02700001 and.w #1,D1 Isolate bit 

005AA6 3B410664 move.w D1,$664(A5) And save 

005AAA 322D0A8C move.w SA8C(A5),D1 Get printer configuration 
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005AE3 FF dc.b -1 (ATARI color daisy wheel ?) 

005AE4 03 dc.b 3 Epson B/W matrix 

005AE5 FF dc.b -1 (Epson B/W daisy wheel) 

005AE6 FF dc.b -1 (Epson color matrix) 

005AE7 FF dc.b -1 (Epson color daisy wheel) 


Abacus Software 


Atari ST Internals 
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006076 E3A0 asl.l D1,D0 Bits 0-15 to 16-31 

006078 80B9000004BA or.l $4BA,D0 Plus 200 Hz counter 

00607E 23C0000025FA move.l D0,$25FA Use as start value 
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0074 FA 0101010101010202 dc.b 1 , 1 , 1 , 1 , 1 , 2,2 

007502 01020405080AOB10 dc.b 1,2,4,5,8,10,11,16 Low byte 

00750B 204060808FAF4060 dc.b 32,64,96,128,143,175,64,96 
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0075AC 4A2D0A32 tst.b $A32(A5) Keyboard state 

0075B0 6654 bne $7606 

0075B2 0C0000F6 cmp.b #$F6,D0 Keypress ? 

0075B6 650000F4 bcs $76AC Yes 


0075 BA 040000 F 6 sub.b #$F 6 ,D 0 Subtract offset 
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00762 C 22722004 move.l 4 (A 2 ,D 2 .w) ,A 1 IKBD index base 

007630 24722008 move.l 8 <A 2 ,D 2 .w) ,A 2 IKBD interrupt routine 
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***************************************************** setmouse, set mouse parameters 

007B70 14EB0002 move.b 2<A3),<A2)+ x threshold, scale, delta 

007B74 14EB0003 move.b 3(A3),(A2) + y threshold, scale, delta 
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Appendix 

v 


4.1 The System Fonts 

4.2 Alphabetical listing of GEMDOS functions 
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4.1 The System Fonts 


Atari ST Internals 


The operating system contains three system fonts for character output. 

The 6X6 font is used by the Icons, the 8X8 font is the standard font for 
output on the color monitor, and the 8X16 font is used for the monochrome 
monitor output. The chart on the next page includes the characters with the 
ASCII codes 1 to 255. 
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6X6 System Font 


8X8 System Font 


8X16 System Font 
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4.2 Alphabetical listing of GEMDOS functions 


Name Opcode (hex) Page Number 


Cauxin 

03 

106 

Cauxis 

12 

111 

Cauxos 

13 

111 

Cauxout 

04 

106 

Cconin 

01 

105 

Cconis 

OB 

110 

Cconos 

10 

111 

Cconout 

02 

106 

Cconrs 

0A 

109 

Cconws 

09 

109 

Cnee in 

08 

108 

Cpmos 

11 

111 

Cpmout 

05 

107 

Crawcin 

07 

108 

Crawio 

06 

107 

Dcreate 

39 

117 

Ddelete 

3A 

118 

Dfree 

36 

116 

Dgetdrv 

19 

111 

Dgetpath 

47 

128 

Dsetdrv 

0E 

110 

Dsetpath 

3B 

119 

Fattrib 

43 

126 

Fclose 

3E 

122 

Fcreate 

3C 

120 

Fdatime 

57 

137 

Fdelete 

41 

124 

Fdup 

45 

128 

Fforce 

46 

128 

Fgetdta 

2F 

115 

Fopen 

3D 

121 

Fread 

3F 

123 

Frename 

56 

136 

Fseek 

42 

125 

Fsetdta 

1A 

112 

Fsfirst 

4E 

134 

Fsnext 

4F 

136 

Fwrite 

40 

124 
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Malloc 

48 

129 

Mfree 

49 

130 

Mshrink 

4A 

131 

Pexec 

4B 

132 

Pterm 

4C 

133 

PtermO 

00 

105 

Ptermres 

31 

115 

Super 

20 

112 

Sversion 

30 

115 

Tgetdate 

2A 

113 

Tgettime 

2C 

114 

Tsetdate 

2B 

114 

Tsettime 

2D 

115 
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ACIA 6850--see Asynchronous Communications Interface Adapter 

address bus, 7, 8 
asynchronous bus control, 8-9 

ADDRESS STROBE(AS), 8 
DTACK, 9, 10, 12 
LOWER DATA STROBE(LDS), 8 
READ/WRITE(R/W), 8 

UPPER DATA STROBE(UDS), 8 _ 4 . 

Asynchronous Communications Interface Adapter(ACIA), 41-4/, oz-w 
pins, 41-44 
registers, 45-47 

control register, 45-46 
status registers, 46-47 


Basic Input Output System(BIOS), 140-154, 242, 246, 247 
listing, 268-442 

BCD— see Binary Coded Decimal 

BERR, 11, 12, 15 

BG— see Bus Grant 

BGACK-see Bus Grant Acknowledge 

BGO-see Bus Grant Out 

Binary Coded Decimal (BCD), 4 

BIOS— see Basic Input Output System 

BLANK, 15 

BR-see Bus Request 

Bus Grant(BG), 10, 13 

Bus Grant Acknowledge(BGACK), 10, 13 

Bus Grant Out(BGO), 13 

Bus Request(BR), 10, 13 

cartridge slot, 96 
Centronics interface, 88-89 
CLK, 11 

data bus , 7 
data registers, 4 
Data Request(DR), 22 
DE— see Display Enable 

Direct Mern^^Access(DM A), 8-9, 12-13, 18-19, 25, 58-59, 99-100 
Display Enable(DE), 15 
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DMA— see Direct Memoiy Access 
DR— see Data Request 


exception vectors, 234-236 

FDC— see Floppy Disk Controller 
Floppy Disk Controller(FDC), 20-27 
Command Register(CR), 24 
Data Register(DR), 24 
Sector Register(SR), 24 
Status Register(STR), 24 
Track Register(TR), 24 
floppy disk interface, 97-98 

GEM graphics, 206-233 
high-res, 209-212 
line-A opcodes, 229-233 
line-A variables, 226-228 
lo-res, 208-209 
medium-res, 209-210 
GEM graphics - commands, 213-233 
BITBLT, 218 

COPY RASTER FORM, 225-226 
DRAW SPRITE, 224-225 
FILLED POLYGON, 217 
FILLED RECTANGLE, 216 
GET PIXEL, 213 
HIDE CURSOR, 223 
HORIZONTAL LINE, 215 
Initialize, 213 
LINE, 214 
PUT PIXEL, 213 
SHOW MOUSE, 223 
TEXTBLT, 218-222 
TRANSFORM MOUSE, 223-224 
UNDRAW SPRITE, 224 
GEMDOS, 103-139, 242 
functions, 104-138 
error messages, 139 
GLUE, 13-15, 18,69 


HALT, 11, 12 
HSYNC, 15 
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LACK, 13 

integrated circuits, 3-63 
INTEL 3 

interrupts, 7, 10, 236-241 
I/O registers, 55-63 
ACIAs, 62 

DMA/Disk Controller, 58-59 

keyboard, 62 

MFP 68901, 60-61 

MIDI, 62, 240 

sound chip, 59-60 

Video Display Register, 56-58 

keyboard control, 67-71, 74-84 

longword, 7 

Memory Management Unit(MMU), 11, 13, 15-16, 18, 55 

memory maps, 62-63 

MFP 68901 -see Multi-Function Peripheral 

MFPINT, 13 

MIDI -see Musicial Instrument Digital Interface 
MMU-see Memory Management Unit 
Motorola 68000 microprocessor, 3-12, 255-267 
registers, 4-6 
exceptions, 7 
connections, 7-12 
instruction set, 255-267 
mouse, 7 1 -74 
MS-DOS, 104, 180 

Multi-Function Peripheral (MFP 68901), 28-40, 60-61, 90, 171, 239, 241 
Active Edge Register(AER), 32 
connections, 28-32 
Data Direction Register(DDR), 32 
General Purpose I/O Interrupt Port(GPEP), 32 
Interrupt Enable Register(IERA,IERB), 33 
Interrupt In-Service Register(ISRA,ISRB), 34 
Interrupt Mask Register(IMRA,IMRB), 34 
Interrupt Pending Register(IPRA,IPRB), 33-34 
Receiver Status Register(RSR), 38-39 
registers, 32-40 

Synchronous Character Register(SCR), 37 
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Timer A/B Control Register(TACR,TBCR), 35 

Timers C and D Control Register(TCDCR), 36 

Timer Data Registers (T ADR ,TB DR,TCDR,TDDR) , 37 

Transmitter Status Register(TSR), 39-40 

UCR/USART, 37-38 

UDR/USART, 40 

Vector Register(VR), 34 

Musical Instruement Digital Interface(MIDI), 93-95, 170 

NMI-see non-maskable interrupt 
non-maskable interrupt (NMI), 6, 13, 237 

operating system, 103 

PSG (Programmable Sound Generator)-see YM-2149 Sound Generator 
RESET, 11, 12 

RS-232 interface, 90-92, 240-241 

SHIFTER, 13, 15, 17, 18 
status register, 6 
supervisor mode, 4, 6, 7, 234 
synchronous bus control, 9 
E,9 

Valid Memory Address(VMA), 9 
Valid Peripheral Address(VPA), 9, 10 

system fonts, 443-446 
system variables, 247-254 

Tramiel Operating System(TOS),103 

UNIX, 104 

user byte ,4 

user mode ,4, 6, 7, 234 

video interface, 85-87 
VSYNC, 15 

VT52 emulator, 242-246 

WD 1772, 20-27 
word, 7 
word access, 8 
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XBIOS, 155-205 

YM-2149 Sound Generator, 48-54 

attack/decay /sustain/release(ADSR), 48 
digital/analog(D/A) converter, 48 
registers, 52-54 
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Optional Diskette 


For your convenience, the program listings contained in this book are 
available on an SF354 formatted floppy disk. You should order the diskette 
if you want to use the programs, but don’t want to type them in from the 
listings in the book. 

All programs on the diskette have been fully tested. You can change the 
programs for your particular needs. The diskette is available for $14.95 plus 
$2.00 ($5.00 foreign) for postage and handling. 

When ordering, please give your name and shipping address. Enclose a 
check, money order or credit card information. Mail your order to: 

Abacus Software 
P.O. Box 7219 
Grand Rapids, MI 495 10 



Or for fast service, call 616/241-5510. 





DDAFESSIONAL 

rnUDUCTIVITY 


New ST software from a name you can count on... 



PCBoard 

Designer 

Create printed circuit board layouts 



Features; Aula-routing, component 
list, pinout list, net list 



PCBoard Designer 
Interactive, computer-aided design 
package that automates layout ot 
printed circuit boards. Auto-routing 
with 45" or 90‘ traces; two-sided 


hoards; pin-to pin. pin-to-BUS or BUS- 
to-BUS. Rubberbanding of components 
during placement. Prints board layout, 
pinout, component list, net list. Output 
to Epson printer at 2:1. Pays tor itself 
after first designed board. $395.00 



ST TextPro 

Wordprocessor with professional 
features and easy to-usel Full-screen 
editing with mouse or keyboard 
shortcuts. High speed input, scrolling 
and editing; sideways printing; 
multi-column output; flexible printer 
installation; automatic index and table 
of contents; up to 180 charsrtine; 30 
definable function keys; metafile 
output; much more. $49.95 


FilePro 



ST FilePro 


A simple-to-use and versatile database 
manager. Features help screens; 
lightning-fast operation; taitorable 
display using multiple fonts; 
user-delinable edit masks; capacity up 
to 64,000 records. Supports multiple 
files. RAM-disk support for 1040ST. 
Complete search, sort and file 
subselting. Interfaces to TextPro. Easy 
printer control. $49.95 



ST Forlfl/MT 

Powerful, multi-tasking Forth for 
the ST. A complete. 3Z-b'fl Impte 
mentation based on Forth-83 
standard. Development aids: full 
screen editor, monitor, macro 
assembler. 1500* word library. 
TOSILIN6A commands. Floating 
point and complex arithmetic. 
Available Sept. ’86 *49.95 


ST PatntPre 

A GEM™ among ST drawing 
programs. Vary triendty, but very 
powerful. A most tor everyone's 
artislic or graphics needs. Use 
up to three windows. Free-foim 
sketching; lines, circles, ellipses, 
boxes, text, till, copy, move, 
zoom, spray, paint, erase, undo, 
hefc. $49.95 


ST Text Deslgnnf 
An Weal package lor page layout 
on the ST. Accepts prepared text 
Hes Irom TextPro or other ASCII 
wordprocessors. Performs block 
operations— copy. move, col- 
umns. Merges bitmapped 
graphics Tools to add borders 8 
separator lines, more. Available 
September '86. $49.95 


AssemPro 

The complete 68000 
assembler development 
package for the ST 



ST AssemPro 

Professional developer's pack- 
age includes editor, two-pass 
interactive assembler with error 
locator, online help Including 
instruction address mode and 
GEM parameter inlormation. 
monitor-debugger, disassembler 
and 68020 simulator, more. 
Available Sept. '86 $59.95 


Abacus ini Software 


ST and IDtfOST are Iratoma/fcs o< A*3ilCoip. 
GEM Is a Jtadema/X o I Resoa/ch toe. 


P.0. Box 7219 Dept# Grand Rapids, Ml 49510 - Telex 709-101 - Phone (616) 241-5510 

Call now for the name ot your nearest dealer. Or order directly from ABACUS with your MasterCard, VISA, or Amex card. Add 
$4.00 per order for postage and handling. Foreign add $10.00 per item. Other software and books coming soon. Call or 
write for your free catalog. Dealer inquiries welcome-over 1400 dealers nationwide. 















AssemPro 


The complete 68000 
assembler development 
package for the ST 



AssemPro is the professional developer’s 
package for programming in 68000 assembly 
language on the ST. The package includes: 
editor, two-pass interactive assembler with error 
locator, online help including instruction address 
mode and GEM parameter information, 
monitor-debugger, disassembler and 68020 
simulator. $59.95 



FilePro 
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FilePro is a simple io use but flexible data 
manager. The drop-down menus allow you to 
quickly define your file and enter your information 
through screen templates. FilePro has many 
unique features: store data items in different type 
styles; create subsets of a file; change file 
definition and format; includes and supports a 
RAM disk for high speed operation. FilePro also 
has a fast search and sort capabilities, can 
handle records up to 64,000 characters in length, 
allows numerical values with up to 15 significant 
digits, accesses up to 4 files simutaneously, 
indexes up to 20 different fields per file and has 
complete, built-in reporting capabilities. $49.95 


Word processor for the ST 


TextPro is a professional quality wordprocessor. 
In addition to the standard options found in most 
other word processors, TextPro features 
multi-column output automatic indexing and table 
of contents, sideways printing (to Epson printers), 
up to 30 user definable function keys, mode for 
editing C language source programs and flexible 
printer driver installation. It is designed with fast 
entry of text in mind. The advanced TextPro user 
can substitute shortcut keyboard commands for 
the drop-down menu commands. $49.95 




Wilh Text Designer you 
are now able to combine 
text with graphics on your 
screen. Add artwork to 
your page layouts. Liven 
up your pages with 
pictures to add that 
crural fl-iir. 




ignet/ 


Combine graphics 
with your text 



rayums; 
pages 
es to add that 
I flair. 



TextDesigner is an ideal package for page layout 
on the ST allowing you to interlace graphics with 
text. TextDesigner reduces the steps and time 
involved in preparing professional documents 
and newsletters. Use the tools provided for 
borders, lines, text, etc. or cut and paste from 
PaintPro, Doodle, Degas, TextPro and other 
ASCII word processors. TextDesigner is a simple 
to use and versatile package which will give you 
the professional results you deserve at a 
reasonable cost. $49.95 




PaintPro is a friendly, yet powerful design and 
painting package for drawing graphic and artistic 
pictures. This GEM-based package supports up to 
three active windows and has a complete toolkit 
of functions: free-form sketching, lines, circles, 
ellipses, boxes, fill, copy, move, spray, zoom, 
undo, help and extensive text capabilities. You 
can also import "foreign" pictures for 
enhancement using Paintpro’s double-sized 
picture format and send hardcopy to most popular 
dot-matrix printers. PaintPro works with either 
monochrome or color systems. $49.95 





Forth/MT, the multi-tasking, full-featured Forth 
language for the ST, is for serious programmers. 
Forth/MT is a complete, 32-bit implementation 
based on Forth ‘83 standard. Includes many 
development aids: full screen editor, monitor, 
macro assembler, over 1500 word library. 
Includes TOS, LINEA, floating-point and complex 
arithmetic commands. $49.95 
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and shade 3D object*. An 
program* written in machine 
language for high speed 
learn the meiha malice 
behind aDgtepMc* Hidden 
Rrta removal, shading. Wrth 
3D pcflarn maker and 
animator. $24.95 
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INTERNALS 


This INTERNALS volume is a welcome addition to any ST 
programmer’s library. Inside you’ll find important hardware and 
programming information for your ST. Contains valuable 
information for the professional programmer and ST novice. 
Here is a short list of some of the things you can expect to read 
about: 


• 68000 processor 

• WD 1 772 disk controller 

• ACIA's 6850 

• Centronics interface 

• MIDI-interface 

• GEMDOS 

• Interrupt instructions 

• BIOS listing 


• Custom chips 

• MFP 68901 

• YM-21 49 sound generator 

• RS-232 

• DMA controller 

• BIOS &XBIOS 

• Error codes 

• Blitter chip 
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Development team, based in Duesseldorf, W. Germany. They 
are all best selling computer book authors and very 
knowledgable concerning the subjects presented in this book. 
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